QContextMenuEvent Class

Ausführliche Beschreibung

Ein Kontextmenü-Ereignis wird ausgelöst, wenn ein Benutzer eine Aktion ausführt, die ein Kontextmenü öffnen soll:

• Klicken mit der rechten Maustaste
• Drücken einer speziellen Menütaste auf der Tastatur (sofern die Tastatur über eine solche verfügt, wie z. B. die Menütaste auf Standard-PC-Tastaturen mit 104 Tasten)
• Drücken einer anderen Tastenkombination (z. B. standardmäßig „Strg+Return“ unter macOS 15 und neuer)

Das erwartete Kontextmenü sollte „ actions “ enthalten, die für bestimmte Inhalte innerhalb der Anwendung (den „Kontext“) relevant sind. In Qt ist der Kontext mindestens das jeweilige „ widget “ oder „ Qt Quick “ Item, das das „QContextMenuEvent“ empfängt. Liegt eine Auswahl vor, sollte diese wahrscheinlich als Kontext behandelt werden. Der Kontext kann mithilfe von „ QContextMenuEvent::pos “ () weiter verfeinert werden, um den Inhalt innerhalb des Widgets, des Elements oder der Auswahl genau zu bestimmen.

Widgets können die Methode ` QWidget::contextMenuEvent()` überschreiben, um dieses Ereignis zu verarbeiten. Viele Widgets tun dies bereits und verfügen standardmäßig über nützliche Kontextmenüs. Einige Widgets verfügen über eine Funktion wie ` createStandardContextMenu()`, um den Standard-Aktionssatz in ein ` QMenu` zu übertragen, das in Ihrer Unterklasse weiter angepasst und anschließend angezeigt werden kann.

In ` Qt Quick` kann das Ereignis über die angehängte Eigenschaft ` ContextMenu ` verarbeitet werden. Einige ` QtQuick.Controls `-Steuerelemente bieten bereits standardmäßig Kontextmenüs an.

Im Gegensatz zu den meisten synthetischen Ereignissen (wie z. B. einem „ QMouseEvent “, das erst gesendet wird, nachdem ein „ QTouchEvent “ oder „ QTabletEvent “ nicht akzeptiert wurde) wird „QContextMenuEvent“ unabhängig davon gesendet, ob das ursprüngliche Maus- oder Tastenereignis bereits verarbeitet wurde und „ accepted “ aufgerufen wurde. Dies dient dazu, dem Windows-UI-Muster Rechnung zu tragen, bei dem bestimmte Elemente (Symbole, Zeichenelemente oder Zellen in einer Item-Ansicht) mit der rechten Maustaste (durch Klicken oder Ziehen) ausgewählt werden und dann ein Kontextmenü erscheint, sobald die rechte Maustaste losgelassen wird. (Die Aktionen im Menü sollen auf die Auswahl angewendet werden.) Daher wird unter Windows das `QContextMenuEvent` beim Loslassen der Maustaste gesendet, während es auf anderen Plattformen beim Drücken gesendet wird. Qt folgt standardmäßig dem „ platform convention “.

Es gibt auch einige „ Qt Quick Controls “ wie beispielsweise „ Pane “, die Mausereignisse akzeptieren und dennoch nach einem Mausdruck oder -klick ein „QContextMenuEvent“ empfangen.

Wenn Sie das UI-Muster „Drücken-Ziehen-Loslassen“ unterstützen möchten, bei dem ein Kontextmenü beim Drücken geöffnet und ein Menüelement durch Ziehen über den Eintrag beim Loslassen ausgewählt wird, müssen Sie dies durch direkte Behandlung von „ QMouseEvents “ umsetzen (indem Sie „ virtual functions “ in Unterklassen von „ QWidget “ überschreiben oder „ TapHandler “ verwenden, um ein „ Menu “ in „ Qt Quick “ zu öffnen); und dann ist das `QContextMenuEvent` überflüssig, wenn ` reason()` auf ` Mouse` gesetzt ist. In diesem Fall sollten Sie das Ereignis mit ` ignore()` abfangen; Sie sollten jedoch weiterhin sicherstellen, dass das Widget, das benutzerdefinierte Steuerelement oder die Anwendung auf ein `QContextMenuEvent` reagieren kann, das ` comes from ` den plattformspezifischen Tastaturbefehl enthält.

Wenn ein `QContextMenuEvent` als ` ignored` gekennzeichnet ist, versucht Qt, es an andere Widgets und/oder Elemente unterhalb des „ position “ (der in der Regel aus der Cursorposition abgeleitet wird) weiterzuleiten.