Compartilhar via


PopupMenu Classe

Definição

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class PopupMenu final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class PopupMenu
[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

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.

Aplica-se a

Confira também