PopupMenu.ShowAsync(Point) 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.
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.