SecondaryTile.RequestCreateForSelectionAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| RequestCreateForSelectionAsync(Rect) |
Visualizza il riquadro a comparsa Aggiungi a Start sopra un'area specificata. Questo riquadro a comparsa viene usato dall'utente per confermare che vogliono creare il riquadro secondario, che a sua volta crea il riquadro.
|
| RequestCreateForSelectionAsync(Rect, Placement) |
Visualizza il riquadro a comparsa Aggiungi a Start sul lato specificato di un'area specificata. Questo riquadro a comparsa viene usato dall'utente per confermare che vogliono creare il riquadro secondario, che a sua volta crea il riquadro.
|
RequestCreateForSelectionAsync(Rect)
Visualizza il riquadro a comparsa Aggiungi a Start sopra un'area specificata. Questo riquadro a comparsa viene usato dall'utente per confermare che vogliono creare il riquadro secondario, che a sua volta crea il riquadro.
In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza visualizzare l'utente in un riquadro a comparsa, richiedendole la conferma o consentendo loro di scegliere una dimensione del riquadro o un testo del titolo. Si noti che quando si usa il metodo RequestCreateAsync per aggiungere un riquadro secondario in Windows Phone'app 8.x, l'app viene sospesa e l'utente viene visualizzato nella schermata Start. Questa stessa chiamata API su un PC non sospende il programma. Pertanto, tenere presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, è consigliabile usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento Riquadro nell'esempio di sospensione.
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)Parametri
- selection
- Rect
L'area visualizzata direttamente sopra il riquadro a comparsa.
Restituisce
Oggetto che fornisce informazioni sull'operazione di creazione asincrona.
- Attributi
Commenti
Dopo aver creato un riquadro secondario, è necessario specificare le proprietà seguenti prima della visualizzazione:
Si applica a
RequestCreateForSelectionAsync(Rect, Placement)
Visualizza il riquadro a comparsa Aggiungi a Start sul lato specificato di un'area specificata. Questo riquadro a comparsa viene usato dall'utente per confermare che vogliono creare il riquadro secondario, che a sua volta crea il riquadro.
In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza visualizzare l'utente in un riquadro a comparsa, richiedendole la conferma o consentendo loro di scegliere una dimensione del riquadro o un testo del titolo. Si noti che quando si usa il metodo RequestCreateAsync per aggiungere un riquadro secondario in Windows Phone'app 8.x, l'app viene sospesa e l'utente viene visualizzato nella schermata Start. Questa stessa chiamata API su un PC non sospende il programma. Pertanto, tenere presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, è consigliabile usare l'evento OnSuspended dell'app per eseguire qualsiasi codice, ad esempio l'aggiornamento del riquadro aggiunto, che deve essere eseguito prima della sospensione dell'app. Per visualizzare un esempio di questo modello, scaricare ed eseguire l'aggiornamento Riquadro nell'esempio di sospensione.
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)Parametri
- selection
- Rect
Area a un lato della quale verrà visualizzato il riquadro a comparsa.
- preferredPlacement
- Placement
Lato del rettangolo in cui dovrebbe essere visualizzato il riquadro a comparsa.
Restituisce
Oggetto che fornisce informazioni sull'operazione di creazione asincrona.
- Attributi