QWidgetAction Class

Ausführliche Beschreibung

Die meisten Aktionen in einer Anwendung werden als Einträge in Menüs oder als Schaltflächen in Symbolleisten dargestellt. Manchmal sind jedoch komplexere Widgets erforderlich. Beispielsweise kann eine Zoom-Aktion in einem Textverarbeitungsprogramm mithilfe eines „ QComboBox “ in einem „ QToolBar “ realisiert werden, wodurch verschiedene Zoomstufen dargestellt werden. „ QToolBar “ stellt „ QToolBar::insertWidget()“ als Komfortfunktion zum Einfügen eines einzelnen Widgets bereit. Wenn Sie jedoch eine Aktion implementieren möchten, die benutzerdefinierte Widgets zur Visualisierung in mehreren Containern verwendet, müssen Sie eine Unterklasse von „QWidgetAction“ erstellen.

Wird eine `QWidgetAction` beispielsweise zu einem ` QToolBar ` hinzugefügt, wird ` QWidgetAction::createWidget()` aufgerufen. Neaimplementierungen dieser Funktion sollten ein neues benutzerdefiniertes Widget mit dem angegebenen übergeordneten Widget erstellen.

Wird die Aktion aus einem Container-Widget entfernt, wird ` QWidgetAction::deleteWidget()` mit dem zuvor erstellten benutzerdefinierten Widget als Argument aufgerufen. Die Standardimplementierung blendet das Widget aus und löscht es mithilfe von ` QObject::deleteLater()`.

Wenn Sie nur ein einziges benutzerdefiniertes Widget haben, können Sie es mit ` setDefaultWidget()` als Standard-Widget festlegen. Dieses Widget wird dann verwendet, wenn die Aktion zu einem ` QToolBar` oder allgemein zu einem Aktionscontainer hinzugefügt wird, der `QWidgetAction` unterstützt. Wird eine `QWidgetAction` mit nur einem Standard-Widget gleichzeitig zu zwei Symbolleisten hinzugefügt, wird das Standard-Widget nur in der ersten Symbolleiste angezeigt, zu der die Aktion hinzugefügt wurde. `QWidgetAction` übernimmt die Eigentümerschaft über das Standard-Widget.

Beachten Sie, dass es dem Widget obliegt, die Aktion zu aktivieren, beispielsweise durch die Neuimplementierung von Mausereignis-Handlern und den Aufruf von ` QAction::trigger()`.

macOS: Wenn Sie unter macOS ein Widget zu einem Menü in der Menüleiste der Anwendung hinzufügen, wird das Widget zwar hinzugefügt und funktioniert auch, allerdings mit einigen Einschränkungen:

1. Das Widget wird vom „ QMenu “ auf die native Menüansicht umgeleitet. Wenn Sie das Menü an einer anderen Stelle anzeigen (z. B. als Popup-Menü), ist das Widget dort nicht vorhanden.
2. Die Fokus- und Tastatursteuerung des Widgets ist nicht möglich.
3. Aufgrund der Gestaltung durch Apple funktioniert die Mausverfolgung auf dem Widget derzeit nicht.
4. Das Verbinden des Signals „ triggered “ () mit einem Slot, der einen modalen Dialog öffnet, führt unter macOS 10.4 zu einem Absturz (bekannter, von Apple bestätigter Fehler); als Workaround kann anstelle einer „DirectConnection“ eine „QueuedConnection“ verwendet werden.