PopupMenu.ShowAsync(Point) Método

Definição

Namespace:

Windows.UI.Popups

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

IAsyncOperation<IUICommand>

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.

Confira também

• IUICommand
• Point
• Commands
• UICommand
• Adicionando menus de contexto
• Exemplo de menu de contexto
• Diretrizes e lista de verificação para
• oncontextmenu