SecondaryTile.RequestCreateAsync Metodo

Definizione

Spazio dei nomi:

Windows.UI.StartScreen

Overload

RequestCreateAsync()

Visualizza il riquadro a comparsa Aggiungi all'avvio , tramite il quale l'utente può confermare di voler creare il riquadro secondario, che a sua volta crea il riquadro. Gli overload di questo metodo consentono di specificare la posizione sullo schermo del riquadro a comparsa. Nota È consigliabile visualizzare il riquadro a comparsa Aggiungi all'avvio accanto al pulsante che ha richiamato la richiesta per creare il riquadro. È pertanto consigliabile usare il formato RequestCreateAsync(Point) di questo overload del metodo. In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza mostrare all'utente 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. Tenere quindi presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, devi 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.

RequestCreateAsync(Point)

Visualizza il riquadro a comparsa Aggiungi alla schermata Start sopra una posizione specificata, tramite cui l'utente può confermare di voler 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 mostrare all'utente 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. Tenere quindi presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, devi 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.

RequestCreateAsync()

Visualizza il riquadro a comparsa Aggiungi all'avvio , tramite il quale l'utente può confermare di voler creare il riquadro secondario, che a sua volta crea il riquadro. Gli overload di questo metodo consentono di specificare la posizione sullo schermo del riquadro a comparsa.

Nota

È consigliabile visualizzare il riquadro a comparsa Aggiungi all'avvio accanto al pulsante che ha richiamato la richiesta per creare il riquadro. È pertanto consigliabile usare il formato RequestCreateAsync(Point) di questo overload del metodo.

In Windows Phone 8.1, il riquadro secondario viene creato tramite questa chiamata senza mostrare all'utente 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. Tenere quindi presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, devi 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> ^ 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)

Restituisce

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Oggetto utilizzato per avviare l'operazione di creazione asincrona e per recuperare informazioni su di esso.

Attributi

OverloadAttribute

Commenti

Dopo aver creato un riquadro secondario, è necessario specificare le proprietà seguenti prima che venga visualizzato:

• tileId
• displayName
• Argomenti
• SecondaryTileVisualElements.Square150x150Logo

Questo metodo restituisce un valore booleano asincrono tramite l'oggetto IAsyncOperation , come illustrato di seguito. Il valore true indica che il riquadro secondario è stato creato e aggiunto alla schermata Start.

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

RequestCreateAsync(Point)

Visualizza il riquadro a comparsa Aggiungi alla schermata Start sopra una posizione specificata, tramite cui l'utente può confermare di voler 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 mostrare all'utente 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. Tenere quindi presente che qualsiasi codice chiamato dopo RequestCreateAsync non è garantito che venga eseguito prima che l'app venga sospesa. Per evitare questo potenziale problema, devi 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> ^ 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)

Parametri

invocationPoint

Point

Punto utilizzato come angolo inferiore destro del riquadro a comparsa Aggiungi all'avvio .

Restituisce

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Oggetto che fornisce informazioni sull'operazione di creazione asincrona.

Attributi

OverloadAttribute