Lire en anglais

Partager via


SecondaryTile.RequestCreateAsync Méthode

Définition

Surcharges

RequestCreateAsync()

Affiche le menu volant Épingler à l’écran d’accueil , via lequel l’utilisateur peut confirmer qu’il souhaite créer la vignette secondaire, qui à son tour crée la vignette. Les surcharges de cette méthode vous permettent de spécifier l’emplacement à l’écran du menu volant.

Notes

Il est recommandé d’afficher le menu volant Épingler à l’écran d’accueil près du bouton qui a appelé la demande de création de la vignette. Par conséquent, nous vous recommandons d’utiliser la forme RequestCreateAsync(Point) de cette surcharge de méthode.

Sur Windows Phone 8.1, la vignette secondaire est créée via cet appel sans afficher à l’utilisateur un menu volant, l’inviter à confirmer ou lui permettre de choisir une taille de vignette ou un texte de titre. Notez que lorsque vous utilisez la méthode RequestCreateAsync pour épingler une vignette secondaire dans Windows Phone application 8.x, l’application est suspendue et l’utilisateur est dirigé vers l’écran d’accueil. Ce même appel d’API sur un PC ne suspend pas le programme. Par conséquent, n’oubliez pas que l’exécution de tout code appelé après RequestCreateAsync n’est pas garantie avant la suspension de l’application. Pour éviter ce problème potentiel, vous devez utiliser l’événement OnSuspended de votre application pour exécuter tout code, tel que la mise à jour de la vignette épinglée, qui doit être exécuté avant la suspension de l’application. Pour afficher un exemple de ce modèle, téléchargez et exécutez l’exemple De mise à jour des vignettes lors de la suspension.

RequestCreateAsync(Point)

Affiche le menu volant Épingler à l’écran de démarrage au-dessus d’un emplacement spécifié, par le biais duquel l’utilisateur peut confirmer qu’il souhaite créer la vignette secondaire, qui à son tour crée la vignette.

Sur Windows Phone 8.1, la vignette secondaire est créée via cet appel sans afficher à l’utilisateur un menu volant, l’inviter à confirmer ou lui permettre de choisir une taille de vignette ou un texte de titre. Notez que lorsque vous utilisez la méthode RequestCreateAsync pour épingler une vignette secondaire dans Windows Phone application 8.x, l’application est suspendue et l’utilisateur est redirigé vers l’écran d’accueil. Ce même appel d’API sur un PC ne suspend pas le programme. Par conséquent, n’oubliez pas que l’exécution de tout code appelé après RequestCreateAsync n’est pas garantie avant la suspension de l’application. Pour éviter ce problème potentiel, vous devez utiliser l’événement OnSuspended de votre application pour exécuter tout code, tel que la mise à jour de la vignette épinglée, qui doit être exécuté avant la suspension de l’application. Pour afficher un exemple de ce modèle, téléchargez et exécutez l’exemple De mise à jour des vignettes lors de la suspension.

RequestCreateAsync()

Affiche le menu volant Épingler à l’écran d’accueil , via lequel l’utilisateur peut confirmer qu’il souhaite créer la vignette secondaire, qui à son tour crée la vignette. Les surcharges de cette méthode vous permettent de spécifier l’emplacement à l’écran du menu volant.

Notes

Il est recommandé d’afficher le menu volant Épingler à l’écran d’accueil près du bouton qui a appelé la demande de création de la vignette. Par conséquent, nous vous recommandons d’utiliser la forme RequestCreateAsync(Point) de cette surcharge de méthode.

Sur Windows Phone 8.1, la vignette secondaire est créée via cet appel sans afficher à l’utilisateur un menu volant, l’inviter à confirmer ou lui permettre de choisir une taille de vignette ou un texte de titre. Notez que lorsque vous utilisez la méthode RequestCreateAsync pour épingler une vignette secondaire dans Windows Phone application 8.x, l’application est suspendue et l’utilisateur est dirigé vers l’écran d’accueil. Ce même appel d’API sur un PC ne suspend pas le programme. Par conséquent, n’oubliez pas que l’exécution de tout code appelé après RequestCreateAsync n’est pas garantie avant la suspension de l’application. Pour éviter ce problème potentiel, vous devez utiliser l’événement OnSuspended de votre application pour exécuter tout code, tel que la mise à jour de la vignette épinglée, qui doit être exécuté avant la suspension de l’application. Pour afficher un exemple de ce modèle, téléchargez et exécutez l’exemple De mise à jour des vignettes lors de la suspension.

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)

Retours

Objet utilisé pour lancer l’opération de création asynchrone ainsi que pour récupérer des informations à son sujet.

Attributs

Remarques

Une fois qu’une vignette secondaire est créée, vous devez fournir les propriétés suivantes avant de l’afficher :

Cette méthode retourne une valeur booléenne asynchrone via son objet IAsyncOperation , comme illustré ici. La valeur true indique que la vignette secondaire a été créée et épinglée à l’écran d’accueil.

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

S’applique à

RequestCreateAsync(Point)

Affiche le menu volant Épingler à l’écran de démarrage au-dessus d’un emplacement spécifié, par le biais duquel l’utilisateur peut confirmer qu’il souhaite créer la vignette secondaire, qui à son tour crée la vignette.

Sur Windows Phone 8.1, la vignette secondaire est créée via cet appel sans afficher à l’utilisateur un menu volant, l’inviter à confirmer ou lui permettre de choisir une taille de vignette ou un texte de titre. Notez que lorsque vous utilisez la méthode RequestCreateAsync pour épingler une vignette secondaire dans Windows Phone application 8.x, l’application est suspendue et l’utilisateur est redirigé vers l’écran d’accueil. Ce même appel d’API sur un PC ne suspend pas le programme. Par conséquent, n’oubliez pas que l’exécution de tout code appelé après RequestCreateAsync n’est pas garantie avant la suspension de l’application. Pour éviter ce problème potentiel, vous devez utiliser l’événement OnSuspended de votre application pour exécuter tout code, tel que la mise à jour de la vignette épinglée, qui doit être exécuté avant la suspension de l’application. Pour afficher un exemple de ce modèle, téléchargez et exécutez l’exemple De mise à jour des vignettes lors de la suspension.

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)

Paramètres

invocationPoint
Point

Point utilisé comme coin inférieur droit du menu volant Épingler au menu volant Démarrer .

Retours

Objet qui fournit des informations sur l’opération de création asynchrone.

Attributs

S’applique à