SecondaryTile.RequestCreateAsync 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
| 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.
|
| 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.
|
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
Um objeto usado para iniciar a operação de criação assíncrona, bem como para recuperar informações sobre ele.
- Atributos
Comentários
Depois que um bloco secundário for criado, você deverá fornecer as seguintes propriedades antes de ser exibido:
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();
}
Aplica-se a
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
Um objeto que fornece informações sobre a operação de criação assíncrona.
- Atributos