SecondaryTile.RequestCreateForSelectionAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
|
| 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.
|
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