Condividi tramite


PopupMenu.ShowAsync(Point) Metodo

Definizione

Mostra il menu di scelta rapida in corrispondenza delle coordinate client specificate.

public:
 virtual IAsyncOperation<IUICommand ^> ^ ShowAsync(Point invocationPoint) = ShowAsync;
IAsyncOperation<IUICommand> ShowAsync(Point const& invocationPoint);
public IAsyncOperation<IUICommand> ShowAsync(Point invocationPoint);
function showAsync(invocationPoint)
Public Function ShowAsync (invocationPoint As Point) As IAsyncOperation(Of IUICommand)

Parametri

invocationPoint
Point

Coordinate (in DIP), relative alla finestra, del puntatore del dito o del mouse dell'utente quando viene generato l'evento oncontextmenu . Il menu viene posizionato sopra e centrato su questo punto.

Nota

Per VB, C# e C++, questa finestra è CoreWindow associata al thread che chiama il menu di scelta rapida.

Restituisce

Oggetto IUICommand che rappresenta il comando di menu di scelta rapida richiamato dall'utente dopo il completamento della chiamata ShowAsync.

Se non viene richiamato alcun comando, ShowAsync restituisce Null.

Esempio

Prima di visualizzare un menu di scelta rapida, è necessario aggiungere un listener di eventi per l'evento oncontextmenu . Ad esempio, l'esempio di menu di scelta rapida è in ascolto dell'evento su elementi HTML specifici e quindi chiama la scenario1AttachmentHandler funzione.

document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);
menu.commands.append(new Windows.UI.Popups.UICommand("Save attachment", onSaveAttachment));

// We don't want to obscure content, so pass in the position representing the selection area.
// We registered command callbacks; no need to handle the menu completion event
menu.showAsync(pageToWinRT(e.pageX, e.pageY)).then(function (invokedCommand) {
    if (invokedCommand === null) {
        // The command is null if no command was invoked.
        WinJS.log && WinJS.log("Context menu dismissed", "sample", "status");
    }
});

Assicurarsi inoltre di verificare che sia stato richiamato un comando ed elaborare tale caso in base alle esigenze dell'app. Se uiCommand richiamato ha una funzione di callback (onSaveAttachment nell'esempio), verrà eseguita la funzione di callback. In caso contrario, potrebbe essere necessario usare UICommand.Id per identificare ed elaborare il comando richiamato.

Commenti

È possibile visualizzare esempi di codice completi che illustrano come creare e personalizzare i menu di scelta rapida nell'esempio di menu di scelta rapida.

Si applica a

Vedi anche