SecondaryTile.RequestCreateAsync Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
|
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.
|
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 à
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