PopupMenu.ShowAsync(Point) Méthode

Référence

Définition

Espace de noms:: Windows.UI.Popups

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.

Modifier

Affiche le menu contextuel aux coordonnées du client spécifiées.

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)

Paramètres

invocationPoint: Point

Coordonnées (en DIPs), par rapport à la fenêtre, du pointeur du doigt ou de la souris de l’utilisateur lorsque l’événement oncontextmenu s’est déclenché. Le menu est placé au-dessus et centré sur ce point.

Notes

Pour VB, C# et C++, cette fenêtre est le CoreWindow associé au thread qui appelle le menu contextuel.

Retours

IAsyncOperation<IUICommand>

Objet IUICommand qui représente la commande de menu contextuel appelée par l’utilisateur, une fois l’appel ShowAsync terminé.

Si aucune commande n’est appelée, ShowAsync retourne null.

Exemples

Avant de pouvoir afficher un menu contextuel, vous devez ajouter un écouteur d’événement pour l’événement oncontextmenu . Par exemple, l’exemple de menu contextuel écoute l’événement sur des éléments HTML spécifiques, puis appelle la scenario1AttachmentHandler fonction.

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");
    }
});

En outre, assurez-vous que vous case activée qu’une commande a été appelée et traitez ce cas en fonction de votre application. Si l’UICommand appelé a une fonction de rappel (onSaveAttachment dans l’exemple), la fonction de rappel est exécutée. Sinon, vous devrez peut-être utiliser UICommand.Id pour identifier et traiter la commande appelée.

Remarques

Vous pouvez voir des exemples de code complets qui montrent comment créer et personnaliser des menus contextuels dans l’exemple de menu contextuel.

S’applique à

Partager via