SecondaryTile.RequestCreateForSelectionAsync Méthode
Définition
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.
Surcharges
| RequestCreateForSelectionAsync(Rect) |
Affiche le menu volant Épingler à l’écran d’accueil au-dessus d’une zone spécifiée. Ce menu volant est utilisé par l’utilisateur pour confirmer qu’il souhaite créer la vignette secondaire, qui à son tour crée la vignette.
|
| RequestCreateForSelectionAsync(Rect, Placement) |
Affiche le menu volant Épingler à démarrer sur le côté spécifié d’une zone spécifiée. Ce menu volant est utilisé par l’utilisateur pour confirmer qu’il souhaite créer la vignette secondaire, qui à son tour crée la vignette.
|
RequestCreateForSelectionAsync(Rect)
Affiche le menu volant Épingler à l’écran d’accueil au-dessus d’une zone spécifiée. Ce menu volant est utilisé par l’utilisateur pour 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 par le biais de cet appel sans afficher de menu volant à l’utilisateur, sans l’inviter à confirmer, ni 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 Mise à jour des vignettes lors de la suspension.
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)Paramètres
- selection
- Rect
Zone dans laquelle le menu volant s’affiche directement au-dessus.
Retours
Objet qui fournit des informations concernant l’opération de création asynchrone.
- Attributs
Remarques
Une fois qu’une vignette secondaire est créée, vous devez fournir les propriétés suivantes avant qu’elle ne s’affiche :
S’applique à
RequestCreateForSelectionAsync(Rect, Placement)
Affiche le menu volant Épingler à démarrer sur le côté spécifié d’une zone spécifiée. Ce menu volant est utilisé par l’utilisateur pour 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 par le biais de cet appel sans afficher de menu volant à l’utilisateur, sans l’inviter à confirmer, ni 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 Mise à jour des vignettes lors de la suspension.
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)Paramètres
- selection
- Rect
Zone d’un côté où le menu volant sera affiché.
- preferredPlacement
- Placement
Côté du rectangle où le menu volant doit apparaître.
Retours
Objet qui fournit des informations concernant l’opération de création asynchrone.
- Attributs