PopupMenu.ShowAsync(Point) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.