Compartilhar via


SecondaryTile.RequestCreateForSelectionAsync Método

Definição

Sobrecargas

RequestCreateForSelectionAsync(Rect)

Exibe o submenu Fixar em Iniciar acima de uma área especificada. Esse submenu é usado pelo usuário para confirmar que deseja criar o bloco secundário, 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.

RequestCreateForSelectionAsync(Rect, Placement)

Exibe o submenu Fixar em Iniciar no lado especificado de uma área especificada. Esse submenu é usado pelo usuário para confirmar que deseja criar o bloco secundário, 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.

RequestCreateForSelectionAsync(Rect)

Exibe o submenu Fixar em Iniciar acima de uma área especificada. Esse submenu é usado pelo usuário para confirmar que deseja criar o bloco secundário, 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> ^ RequestCreateForSelectionAsync(Rect selection) = RequestCreateForSelectionAsync;
/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRect")]
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect const& selection);
[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRect")]
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection);
function requestCreateForSelectionAsync(selection)
Public Function RequestCreateForSelectionAsync (selection As Rect) As IAsyncOperation(Of Boolean)

Parâmetros

selection
Rect

A área em que o submenu é exibido diretamente acima.

Retornos

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

Atributos

Comentários

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

Aplica-se a

RequestCreateForSelectionAsync(Rect, Placement)

Exibe o submenu Fixar em Iniciar no lado especificado de uma área especificada. Esse submenu é usado pelo usuário para confirmar que deseja criar o bloco secundário, 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> ^ RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement) = RequestCreateForSelectionAsync;
/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRectAndPlacement")]
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect const& selection, Placement const& preferredPlacement);
[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRectAndPlacement")]
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement);
function requestCreateForSelectionAsync(selection, preferredPlacement)
Public Function RequestCreateForSelectionAsync (selection As Rect, preferredPlacement As Placement) As IAsyncOperation(Of Boolean)

Parâmetros

selection
Rect

A área para um lado da qual o submenu será exibido.

preferredPlacement
Placement

O lado do retângulo em que o submenu deve aparecer.

Retornos

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

Atributos

Aplica-se a