SecondaryTile.RequestCreateAsync Método

Definição

Namespace:

Windows.UI.StartScreen

Sobrecargas

RequestCreateAsync()

Exibe o submenu Fixar para Iniciar , por meio do qual o usuário pode confirmar que deseja criar o bloco secundário, o que, por sua vez, cria o bloco. As sobrecargas desse método permitem que você especifique o local na tela do submenu. Observação É uma prática recomendada exibir o submenu Fixar para Iniciar próximo ao botão que invocou a solicitação para criar o bloco. Portanto, recomendamos que você use a forma RequestCreateAsync(Point) dessa sobrecarga de método. No Windows Phone 8.1, o bloco secundário é criado por meio dessa chamada sem mostrar ao usuário um submenu, solicitando-lhe confirmação ou permitindo que ele escolha um tamanho de bloco ou texto de título. Observe que, ao usar o método RequestCreateAsync para fixar um bloco secundário em Windows Phone aplicativo 8.x, o aplicativo é suspenso e o usuário é levado para a tela Inicial. Essa mesma chamada à API em um computador não suspende o programa. Portanto, lembre-se de que qualquer código chamado após RequestCreateAsync não tem garantia de ser executado antes que o aplicativo seja suspenso. Para evitar esse possível problema, você deve usar o evento OnSuspended do seu aplicativo para executar qualquer código, como atualizar o bloco fixado, que deve ser executado antes que o aplicativo seja suspenso. Para ver um exemplo desse padrão, baixe e execute a atualização de bloco no exemplo de suspensão.

RequestCreateAsync(Point)

Exibe o submenu Fixar para Iniciar acima de um local especificado, por meio do qual o usuário pode confirmar que deseja criar o bloco secundário, o que, por sua vez, cria o bloco. No Windows Phone 8.1, o bloco secundário é criado por meio dessa chamada sem mostrar ao usuário um submenu, solicitando-lhe confirmação ou permitindo que ele escolha um tamanho de bloco ou texto de título. Observe que, ao usar o método RequestCreateAsync para fixar um bloco secundário em Windows Phone aplicativo 8.x, o aplicativo é suspenso e o usuário é levado para a tela Inicial. Essa mesma chamada à API em um computador não suspende o programa. Portanto, lembre-se de que qualquer código chamado após RequestCreateAsync não tem garantia de ser executado antes que o aplicativo seja suspenso. Para evitar esse possível problema, você deve usar o evento OnSuspended do seu aplicativo para executar qualquer código, como atualizar o bloco fixado, que deve ser executado antes que o aplicativo seja suspenso. Para ver um exemplo desse padrão, baixe e execute a atualização de bloco no exemplo de suspensão.

RequestCreateAsync()

Exibe o submenu Fixar para Iniciar , por meio do qual o usuário pode confirmar que deseja criar o bloco secundário, o que, por sua vez, cria o bloco. As sobrecargas desse método permitem que você especifique o local na tela do submenu.

Observação

É uma prática recomendada exibir o submenu Fixar para Iniciar próximo ao botão que invocou a solicitação para criar o bloco. Portanto, recomendamos que você use a forma RequestCreateAsync(Point) dessa sobrecarga de método.

No Windows Phone 8.1, o bloco secundário é criado por meio dessa chamada sem mostrar ao usuário um submenu, solicitando-lhe confirmação ou permitindo que ele escolha um tamanho de bloco ou texto de título. Observe que, ao usar o método RequestCreateAsync para fixar um bloco secundário em Windows Phone aplicativo 8.x, o aplicativo é suspenso e o usuário é levado para a tela Inicial. Essa mesma chamada à API em um computador não suspende o programa. Portanto, lembre-se de que qualquer código chamado após RequestCreateAsync não tem garantia de ser executado antes que o aplicativo seja suspenso. Para evitar esse possível problema, você deve usar o evento OnSuspended do seu aplicativo para executar qualquer código, como atualizar o bloco fixado, que deve ser executado antes que o aplicativo seja suspenso. Para ver um exemplo desse padrão, baixe e execute a atualização de bloco no exemplo de suspensão.

public:
 virtual IAsyncOperation<bool> ^ RequestCreateAsync() = RequestCreateAsync;

/// [Windows.Foundation.Metadata.Overload("RequestCreateAsync")]
IAsyncOperation<bool> RequestCreateAsync();

[Windows.Foundation.Metadata.Overload("RequestCreateAsync")]
public IAsyncOperation<bool> RequestCreateAsync();

function requestCreateAsync()

Public Function RequestCreateAsync () As IAsyncOperation(Of Boolean)

Retornos

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Um objeto usado para iniciar a operação de criação assíncrona, bem como para recuperar informações sobre ele.

Atributos

OverloadAttribute

Comentários

Depois que um bloco secundário for criado, você deverá fornecer as seguintes propriedades antes de ser exibido:

• tileId
• displayName
• arguments
• SecondaryTileVisualElements.Square150x150Logo

Esse método retorna um valor booliano assíncrono por meio de seu objeto IAsyncOperation , conforme mostrado aqui. Um valor true indica que o bloco secundário foi criado e fixado na tela Inicial.

async void showTileCreateRequest( SecondaryTile tile )  
{
    bool isPinned = await tile.requestCreateAsync();  
}

RequestCreateAsync(Point)

Exibe o submenu Fixar para Iniciar acima de um local especificado, por meio do qual o usuário pode confirmar que deseja criar o bloco secundário, o que, por sua vez, cria o bloco.

No Windows Phone 8.1, o bloco secundário é criado por meio dessa chamada sem mostrar ao usuário um submenu, solicitando-lhe confirmação ou permitindo que ele escolha um tamanho de bloco ou texto de título. Observe que, ao usar o método RequestCreateAsync para fixar um bloco secundário em Windows Phone aplicativo 8.x, o aplicativo é suspenso e o usuário é levado para a tela Inicial. Essa mesma chamada à API em um computador não suspende o programa. Portanto, lembre-se de que qualquer código chamado após RequestCreateAsync não tem garantia de ser executado antes que o aplicativo seja suspenso. Para evitar esse possível problema, você deve usar o evento OnSuspended do seu aplicativo para executar qualquer código, como atualizar o bloco fixado, que deve ser executado antes que o aplicativo seja suspenso. Para ver um exemplo desse padrão, baixe e execute a atualização de bloco no exemplo de suspensão.

public:
 virtual IAsyncOperation<bool> ^ RequestCreateAsync(Point invocationPoint) = RequestCreateAsync;

/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithPoint")]
IAsyncOperation<bool> RequestCreateAsync(Point const& invocationPoint);

[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithPoint")]
public IAsyncOperation<bool> RequestCreateAsync(Point invocationPoint);

function requestCreateAsync(invocationPoint)

Public Function RequestCreateAsync (invocationPoint As Point) As IAsyncOperation(Of Boolean)

Parâmetros

invocationPoint

Point

O ponto usado como o canto inferior direito do submenu Fixar para Iniciar .

Retornos

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Um objeto que fornece informações sobre a operação de criação assíncrona.

Atributos

OverloadAttribute