PopupMenu Klasse

Definition

Namespace:

Windows.UI.Popups

Stellt ein Kontextmenü dar.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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

Vererbung

Object Platform::Object IInspectable PopupMenu

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Stellen Sie Benutzern ein Kontextmenü bereit, indem Sie einen Ereignislistener für das "contextmenu" Ereignis hinzufügen. Das Kontextmenübeispiel lauscht beispielsweise auf das Ereignis für bestimmte HTML-Elemente und ruft dann die scenario1AttachmentHandler Funktion auf.

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

Um das Kontextmenü anzupassen, rufen Sie preventDefault für das Ereignis auf, um den Standardwert zu unterdrücken, und erstellen Sie dann ein neues, leeres Kontextmenü, wie im Kontextmenübeispiel gezeigt.

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

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

Hinweise

Ein Kontextmenü kann maximal sechs Befehle anzeigen. Dieser Grenzwert trägt dazu bei, dass das Kontextmenü übersichtlich, nutzbar und für Benutzer direkt relevant bleibt.

Vollständige Codebeispiele, die das Erstellen und Anpassen des Kontextmenüs veranschaulichen, finden Sie im Kontextmenübeispiel (Windows 10) und im Kontextmenübeispiel (Windows 8.1).

Für XAML-basierte Desktopanwendungen wird empfohlen, ein Menüflyout zum Implementieren von Kontextmenüs zu verwenden.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Konstruktoren

PopupMenu()

Erstellt eine neue instance der PopupMenu-Klasse. In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

Eigenschaften

Commands

Ruft die Befehle für das Kontextmenü ab.

Methoden

ShowAsync(Point)	Zeigt das Kontextmenü an den angegebenen Clientkoordinaten an.
ShowForSelectionAsync(Rect)	Zeigt das Kontextmenü oberhalb der angegebenen Auswahl an.
ShowForSelectionAsync(Rect, Placement)	Zeigt das Kontextmenü in der bevorzugten Platzierung relativ zur angegebenen Auswahl an.

Weitere Informationen

• Commands
• UICommand
• UICommandSeparator
• Hinzufügen von Kontextmenüs
• Kontextmenübeispiel
• Kontextmenübeispiel (Windows 10)
• Menüs und Kontextmenüs für Desktop-Apps
• Anzeigen von WinRT UI-Objekten, die von CoreWindow abhängig sind