PopupMenu Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.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 PopupMenufunction PopupMenu()Public NotInheritable Class PopupMenu- Herencia
- Atributos
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. |