PopupMenu Clase

Definición

Espacio de nombres:

Windows.UI.Popups

Representa un menú contextual.

En una aplicación de escritorio, antes de usar una instancia de esta clase de una manera que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de 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

Herencia

Object Platform::Object IInspectable PopupMenu

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Proporcione a los usuarios un menú contextual agregando un agente de escucha de eventos para el "contextmenu" evento. Por ejemplo, el ejemplo de menú contextual escucha el evento en elementos HTML específicos y, a continuación, llama a la scenario1AttachmentHandler función .

document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);

Para personalizar el menú contextual, llame a preventDefault en el evento para suprimir el valor predeterminado y, a continuación, cree un nuevo menú contextual vacío, como se muestra en el ejemplo de menú contextual.

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

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

Comentarios

Un menú contextual puede mostrar un máximo de seis comandos. Este límite ayuda a garantizar que el menú contextual permanezca desordenado, utilizable y directamente relevante para los usuarios.

Puede ver ejemplos de código completos que muestran cómo crear y personalizar el menú contextual en el ejemplo de menú contextual (Windows 10) y el ejemplo de menú contextual (Windows 8.1).

En el caso de las aplicaciones de escritorio basadas en XAML, se recomienda usar un control flotante de menú para implementar menús contextuales.

Nota:

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, vea Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).

Constructores

PopupMenu()

Crea una nueva instancia de la clase PopupMenu . En una aplicación de escritorio, antes de usar una instancia de esta clase de una manera que muestre la interfaz de usuario, deberá asociar el objeto con el identificador de ventana de su propietario. Para obtener más información y ejemplos de código, consulta Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

Propiedades

Commands

Obtiene los comandos del menú contextual.

Métodos

ShowAsync(Point)	Muestra el menú contextual en las coordenadas de cliente especificadas.
ShowForSelectionAsync(Rect)	Muestra el menú contextual situado encima de la selección especificada.
ShowForSelectionAsync(Rect, Placement)	Muestra el menú contextual en la ubicación preferida en relación con la selección especificada.

Consulte también

• Commands
• UICommand
• UICommandSeparator
• Agregar menús contextuales
• Ejemplo de menú contextual
• Ejemplo de menú contextual (Windows 10)
• Menús y menús contextuales para aplicaciones de escritorio
• Visualización de objetos de la interfaz de usuario de WinRT que dependen de CoreWindow