Partilhar via


PopupMenu.ShowAsync(Point) Método

Definição

Mostra o menu de contexto nas coordenadas do cliente especificadas.

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)

Parâmetros

invocationPoint
Point

As coordenadas (em DIPs), em relação à janela, do dedo do usuário ou do ponteiro do mouse quando o evento oncontextmenu foi disparado. O menu é colocado acima e centralizado neste ponto.

Observação

Para VB, C# e C++, essa janela é o CoreWindow associado ao thread que está chamando o menu de contexto.

Retornos

Um objeto IUICommand que representa o comando de menu de contexto que foi invocado pelo usuário, após a conclusão da chamada ShowAsync.

Se nenhum comando for invocado, ShowAsync retornará nulo.

Exemplos

Antes de mostrar um menu de contexto, você deve adicionar um ouvinte de eventos para o evento oncontextmenu . Por exemplo, o exemplo de menu Contexto escuta o evento em elementos HTML específicos e chama a scenario1AttachmentHandler função .

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

Além disso, verifique se você marcar que um comando foi invocado e processe esse caso conforme apropriado para seu aplicativo. Se o UICommand invocado tiver uma função de retorno de chamada (onSaveAttachment no exemplo), a função de retorno de chamada será executada. Caso contrário, talvez seja necessário usar UICommand.Id para identificar e processar o comando invocado.

Comentários

Você pode ver exemplos de código completos que demonstram como criar e personalizar menus de contexto no exemplo de menu Contexto.

Aplica-se a

Confira também