PopupMenu Classe

Definição

Namespace:

Windows.UI.Popups

Representa um menu de contexto.

Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

public ref class PopupMenu sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PopupMenu final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PopupMenu

function PopupMenu()

Public NotInheritable Class PopupMenu

Herança

Object Platform::Object IInspectable PopupMenu

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Forneça aos usuários um menu de contexto adicionando um ouvinte de eventos para o "contextmenu" evento. 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);

Para personalizar o menu de contexto, chame preventDefault no evento para suprimir o padrão e, em seguida, crie um novo menu de contexto vazio, conforme mostrado no exemplo de menu Contexto.

e.preventDefault(); // Prevent the default context menu.

var menu = new Windows.UI.Popups.PopupMenu();

Comentários

Um menu de contexto pode mostrar no máximo seis comandos. Esse limite ajuda a garantir que o menu de contexto permaneça não clusterizado, utilizável e diretamente relevante para os usuários.

Você pode ver exemplos de código completos que demonstram como criar e personalizar o menu de contexto no exemplo de menu Contexto (Windows 10) e exemplo de menu contexto (Windows 8.1).

Para aplicativos de área de trabalho baseados em XAML, recomendamos usar um submenu de menu para implementar menus de contexto.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Construtores

PopupMenu()

Cria uma nova instância da classe PopupMenu . Em um aplicativo da área de trabalho, antes de usar uma instância dessa classe de uma maneira que exiba a interface do usuário, você precisará associar o objeto ao identificador de janela do proprietário. Para obter mais informações e exemplos de código, consulte Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

Propriedades

Commands

Obtém os comandos para o menu de contexto.

Métodos

ShowAsync(Point)	Mostra o menu de contexto nas coordenadas do cliente especificadas.
ShowForSelectionAsync(Rect)	Mostra o menu de contexto acima da seleção especificada.
ShowForSelectionAsync(Rect, Placement)	Mostra o menu de contexto no posicionamento preferencial em relação à seleção especificada.

Confira também

• Commands
• UICommand
• UICommandSeparator
• Adicionar menus de contexto
• Exemplo de menu de contexto
• Exemplo de menu de contexto (Windows 10)
• Menus e menus de contexto para aplicativos da área de trabalho
• Exibir objetos da interface do usuário do WinRT que dependem do CoreWindow