QApplication Class

Dokumentation zu den Member-Funktionen

QApplication::QApplication(int &argc, char **argv)

Initialisiert das Fenstersystem und erstellt ein Anwendungsobjekt mit den Befehlszeilenargumenten unter argc in argv.

Der globale Zeiger qApp verweist auf dieses Anwendungsobjekt. Es sollte nur ein einziges Anwendungsobjekt erstellt werden.

Dieses Anwendungsobjekt muss vor allen „ paint devices “ (einschließlich Widgets, Pixmaps, Bitmaps usw.) instanziiert werden.

Alle Qt-Programme unterstützen automatisch die folgenden Befehlszeilenoptionen:

• -style= style, legt den GUI-Stil der Anwendung fest. Die möglichen Werte hängen von Ihrer Systemkonfiguration ab. Wenn Sie Qt mit zusätzlichen Stilen kompiliert haben oder zusätzliche Stile als Plugins verwenden, stehen diese für die Befehlszeilenoption ` -style ` zur Verfügung. Sie können den Stil auch für alle Qt-Anwendungen festlegen, indem Sie die Umgebungsvariable ` QT_STYLE_OVERRIDE ` setzen.
• -style style, entspricht der oben aufgeführten Option.
• -stylesheet= stylesheet, legt das StyleSheet der Anwendung fest. Der Wert muss ein Pfad zu einer Datei sein, die das Style Sheet enthält.

  Hinweis: Relative URLs in der Stylesheet-Datei beziehen sich auf den Pfad der Stylesheet-Datei.

• -stylesheet stylesheet entspricht der oben aufgeführten Option.
• -widgetcount, gibt am Ende eine Debug-Meldung über die Anzahl der noch nicht zerstörten Widgets und die maximale Anzahl der gleichzeitig vorhandenen Widgets aus
• -reverse, legt die Layoutrichtung der Anwendung fest auf Qt::RightToLeft
• -qmljsdebugger=, aktiviert den QML/JS-Debugger mit einem angegebenen Port. Der Wert muss das Format „port:1234[,block]“ haben, wobei „block“ optional ist und bewirkt, dass die Anwendung wartet, bis eine Verbindung zum Debugger hergestellt wird.

Siehe auch QCoreApplication::arguments().

[virtual noexcept] QApplication::~QApplication()

Beendet alle von dieser Anwendung zugewiesenen Systemressourcen des Fenstersystems. Setzt die globale Variable „ qApp “ auf „ nullptr “.

[static slot] void QApplication::aboutQt()

Zeigt ein einfaches Meldungsfenster zu Qt an. Die Meldung enthält die Versionsnummer von Qt, die von der Anwendung verwendet wird.

Dies ist nützlich für die Einbindung in das Menü „ Help “ einer Anwendung, wie im Beispiel „Menüs“ gezeigt.

Diese Funktion ist ein Komfort-Slot für ` QMessageBox::aboutQt()`.

[static] QWidget *QApplication::activeModalWidget()

Gibt das aktive modale Widget zurück.

Ein modales Widget ist ein spezielles Widget der obersten Ebene, das eine Unterklasse von ` QDialog ` darstellt und den Parameter `modal` des Konstruktors auf `true` setzt. Ein modales Widget muss geschlossen werden, bevor der Benutzer mit anderen Teilen des Programms fortfahren kann.

Modale Widgets sind in einem Stapel organisiert. Diese Funktion gibt das aktive modale Widget an der Spitze des Stapels zurück.

Siehe auch „ activePopupWidget()“ und „ topLevelWidgets()“.

[static] QWidget *QApplication::activePopupWidget()

Gibt das aktive Popup-Widget zurück.

Ein Popup-Widget ist ein spezielles Widget der obersten Ebene, das das Flag „ Qt::WType_Popup “ setzt, z. B. das Widget „ QMenu “. Wenn die Anwendung ein Popup-Widget öffnet, werden alle Ereignisse an das Popup gesendet. Auf normale Widgets und modale Widgets kann erst zugegriffen werden, wenn das Popup-Widget geschlossen ist.

Während ein Popup-Widget angezeigt wird, dürfen nur weitere Popup-Widgets geöffnet werden. Die Popup-Widgets sind in einem Stapel angeordnet. Diese Funktion gibt das aktive Popup-Widget an der Spitze des Stapels zurück.

Siehe auch „ activeModalWidget()“ und „ topLevelWidgets()“.

[static] QWidget *QApplication::activeWindow()

Gibt das oberste Anwendungsfenster zurück, das den Tastatureingabefokus hat, oder „ nullptr “, wenn kein Anwendungsfenster den Fokus hat. Es kann ein „activeWindow()“ geben, auch wenn kein „ focusWidget()“ vorhanden ist, beispielsweise wenn kein Widget in diesem Fenster Tastenereignisse akzeptiert.

Siehe auch QWidget::setFocus(), QWidget::hasFocus() und focusWidget().

[static] void QApplication::alert(QWidget *widget, int msec = 0)

Löst die Anzeige einer Meldung für „ widget “ aus, wenn das Fenster nicht das aktive Fenster ist. Die Meldung wird für „ msec “ Millisekunden angezeigt. Ist „ msec “ gleich Null (Standardwert), wird die Meldung so lange angezeigt, bis das Fenster wieder aktiv wird.

Derzeit hat diese Funktion unter Qt für Embedded Linux keine Auswirkung.

Unter macOS wirkt sich dies eher auf Anwendungsebene aus und führt dazu, dass das Anwendungssymbol im Dock auf und ab hüpft.

Unter Windows bewirkt dies, dass der Eintrag des Fensters in der Taskleiste eine Zeit lang blinkt. Ist msec gleich Null, hört das Blinken auf und der Eintrag in der Taskleiste nimmt eine andere Farbe an (derzeit Orange).

Unter X11 wird das Fenster dadurch als „erfordert Aufmerksamkeit“ markiert; das Fenster darf nicht ausgeblendet sein (d. h., es darf nicht mit `hide()` ausgeblendet werden, sondern muss in irgendeiner Form sichtbar sein), damit dies funktioniert.

[static] QWidgetList QApplication::allWidgets()

Gibt eine Liste aller Widgets in der Anwendung zurück.

Die Liste ist leer (QList::isEmpty()) wenn keine Widgets vorhanden sind.

Beispiel:

void updateAllWidgets()
{
    const QWidgetList allWidgets = QApplication::allWidgets();
    for (QWidget *widget : allWidgets)
        widget->update();
}

Siehe auch ` topLevelWidgets()` und ` QWidget::isVisible()`.

[static] void QApplication::beep()

Löst einen Signalton mit der Standardlautstärke und dem Standardklang aus. Diese Funktion ist in Qt für Embedded Linux nicht verfügbar.

[static slot] void QApplication::closeAllWindows()

Schließt alle Fenster der obersten Ebene.

Diese Funktion ist besonders nützlich für Anwendungen mit vielen Fenstern der obersten Ebene.

Die Fenster werden in zufälliger Reihenfolge geschlossen, bis ein Fenster das Schließen nicht mehr akzeptiert. Die Anwendung wird beendet, sobald das letzte Fenster erfolgreich geschlossen wurde, es sei denn, „ quitOnLastWindowClosed “ ist auf „false“ gesetzt. Um das Beenden der Anwendung beispielsweise über ein Menü auszulösen, verwenden Sie „ QCoreApplication::quit()“ anstelle dieser Funktion.

Siehe auch quitOnLastWindowClosed, lastWindowClosed(), QWidget::close(), QWidget::closeEvent(), QCoreApplication::quit(), topLevelWidgets() und QWidget::isWindow().

[override virtual protected] bool QApplication::event(QEvent *e)

Implementiert: ` QGuiApplication::event(QEvent *e)`.

[static] int QApplication::exec()

Tritt in die Hauptereignisschleife ein und wartet, bis „ exit()“ aufgerufen wird; anschließend gibt sie den Wert zurück, der in „ exit()“ festgelegt wurde (dieser ist 0, wenn „ exit()“ über „ quit()“ aufgerufen wird).

Der Aufruf dieser Funktion ist erforderlich, um die Ereignisbehandlung zu starten. Die Hauptereignisschleife empfängt Ereignisse vom Fenstersystem und leitet diese an die Anwendungs-Widgets weiter.

Im Allgemeinen kann vor dem Aufruf von `exec()` keine Benutzerinteraktion stattfinden. Als Sonderfall können modale Widgets wie ` QMessageBox ` vor dem Aufruf von `exec()` verwendet werden, da modale Widgets `exec()` aufrufen, um eine lokale Ereignisschleife zu starten.

Damit Ihre Anwendung eine Leerlaufverarbeitung durchführt, d. h. eine spezielle Funktion ausführt, wenn keine ausstehenden Ereignisse vorliegen, verwenden Sie ein „ QChronoTimer “ mit einem Timeout von 0 ns. Fortgeschrittenere Leerlaufverarbeitungsschemata lassen sich mit „ processEvents()“ realisieren.

Wir empfehlen, Aufräumcode an das Signal ` aboutToQuit()` anzuhängen, anstatt ihn in die Funktion ` main() ` Ihrer Anwendung einzufügen. Der Grund dafür ist, dass der Aufruf von `QApplication::exec()` auf einigen Plattformen möglicherweise nicht zurückkehrt. Auf der Windows-Plattform beispielsweise beendet das System den Prozess, sobald sich der Benutzer abmeldet und Qt alle Fenster der obersten Ebene geschlossen hat. Daher gibt es keine Garantie dafür, dass die Anwendung nach dem Aufruf von QApplication::exec() noch Zeit hat, ihre Ereignisschleife zu verlassen und den Code am Ende der Funktion „ main() “ auszuführen.

Siehe auch quitOnLastWindowClosed, QCoreApplication::quit(), QCoreApplication::exit(), QCoreApplication::processEvents() und QCoreApplication::exec().

[signal] void QApplication::focusChanged(QWidget *old, QWidget *now)

Dieses Signal wird ausgelöst, wenn sich der Tastaturfokus des Widgets von „ old “ zu „ now “ verschoben hat, d. h. weil der Benutzer die Tabulatortaste gedrückt, in ein Widget geklickt oder das aktive Fenster gewechselt hat. Sowohl „ old “ als auch „ now “ können „ nullptr “ sein.

Das Signal wird ausgelöst, nachdem beide Widgets über QFocusEvent über die Änderung informiert wurden.

Siehe auch QWidget::setFocus(), QWidget::clearFocus() und Qt::FocusReason.

[static] QWidget *QApplication::focusWidget()

Gibt das Anwendungs-Widget zurück, das den Fokus für die Tastatureingabe hat, oder „ nullptr “, wenn kein Widget in dieser Anwendung den Fokus hat.

Siehe auch „ QWidget::setFocus()“, „ QWidget::hasFocus()“, „ activeWindow()“ und „ focusChanged()“.

[static] QFont QApplication::font()

Gibt die Standardschriftart der Anwendung zurück.

Siehe auch setFont(), fontMetrics() und QWidget::font().

[static] QFont QApplication::font(const QWidget *widget)

Gibt die Standardschriftart für die Klasse ` widget` zurück. Wenn für die Klasse ` widget` keine Standardschriftart registriert wurde, wird die Standardschriftart der nächstübergeordneten registrierten Oberklasse zurückgegeben.

Siehe auch fontMetrics(), setFont() und QWidget::setFont().

[static] QFont QApplication::font(const char *className)

Gibt die Schriftart für Widgets des angegebenen „ className “ zurück.

Siehe auch ` setFont()` und ` QWidget::font()`.

[static] bool QApplication::isEffectEnabled(Qt::UIEffect effect)

Gibt „ true “ zurück, wenn „ effect “ aktiviert ist; andernfalls wird „ false “ zurückgegeben.

Standardmäßig versucht Qt, die Desktop-Einstellungen zu verwenden. Um dies zu verhindern, rufen Sie setDesktopSettingsAware(false) auf.

Siehe auch setEffectEnabled() und Qt::UIEffect.

[override virtual] bool QApplication::notify(QObject *receiver, QEvent *e)

Implementiert: ` QGuiApplication::notify` (`QObject *object, QEvent *event`).

[static] QPalette QApplication::palette(const QWidget *widget)

Wird ein ` widget ` übergeben, wird die Standardpalette für die Klasse des Widgets zurückgegeben. Dies kann die Anwendungspalette sein, muss es aber nicht. In den meisten Fällen gibt es keine spezielle Palette für bestimmte Widget-Typen, eine bemerkenswerte Ausnahme bildet jedoch das Popup-Menü unter Windows, wenn der Benutzer in den Anzeigeeinstellungen eine spezielle Hintergrundfarbe für Menüs festgelegt hat.

Siehe auch „ setPalette()“ und „ QWidget::palette()“.

[static] QPalette QApplication::palette(const char *className)

Gibt die Palette für Widgets des angegebenen „ className “ zurück.

Siehe auch ` setPalette()` und ` QWidget::palette()`.

[static] void QApplication::setEffectEnabled(Qt::UIEffect effect, bool enable = true)

Aktiviert den UI-Effekt „ effect “, wenn „ enable “ auf „true“ gesetzt ist; andernfalls wird der Effekt nicht verwendet.

Siehe auch „ isEffectEnabled()“, „ Qt::UIEffect “ und „ setDesktopSettingsAware()“.

[static] void QApplication::setFont(const QFont &font, const char *className = nullptr)

Ändert die Standardschriftart der Anwendung auf „ font “. Wird „ className “ übergeben, gilt die Änderung nur für Klassen, die von „ className “ erben (wie von „ QObject::inherits()“ gemeldet).

Beim Start der Anwendung hängt die Standardschriftart vom Fenstersystem ab. Sie kann sowohl je nach Version des Fenstersystems als auch je nach Ländereinstellung variieren. Mit dieser Funktion können Sie die Standardschriftart überschreiben; dies ist jedoch möglicherweise keine gute Idee, da beispielsweise einige Ländereinstellungen besonders große Schriftarten benötigen, um ihre Sonderzeichen darzustellen.

Siehe auch font(), fontMetrics() und QWidget::setFont().

[static] void QApplication::setPalette(const QPalette &palette, const char *className = nullptr)

Ändert die Anwendungspalette auf „ palette “.

Wird „ className “ übergeben, gilt die Änderung nur für Widgets, die von „ className “ erben (wie von „ QObject::inherits()“ gemeldet). Bleibt „ className “ auf 0 gesetzt, wirkt sich die Änderung auf alle Widgets aus und überschreibt somit alle zuvor festgelegten klassenspezifischen Paletten.

Die Palette kann entsprechend dem aktuellen GUI-Stil in QStyle::polish() geändert werden.

Siehe auch QWidget::setPalette(), palette() und QStyle::polish().

[static] void QApplication::setStyle(QStyle *style)

Legt den GUI-Stil der Anwendung auf „ style “ fest. Die Eigentümerschaft am Stilobjekt wird an „ QApplication “ übertragen, sodass „ QApplication “ das Stilobjekt beim Beenden der Anwendung oder dann löscht, wenn ein neuer Stil festgelegt wird und der alte Stil weiterhin das übergeordnete Objekt des Anwendungsobjekts ist.

Anwendungsbeispiel:

QApplication::setStyle(QStyleFactory::create("Fusion"));

Beim Wechseln des Anwendungsstils wird die Farbpalette auf die ursprünglichen Farben oder die Systemstandardwerte zurückgesetzt. Dies ist erforderlich, da bestimmte Stile die Farbpalette anpassen müssen, um vollständig mit dem Styleguide konform zu sein.

Wird der Stil festgelegt, bevor eine Palette definiert wurde, d. h. vor dem Erstellen von ` QApplication`, verwendet die Anwendung ` QStyle::standardPalette()` für die Palette.

Siehe auch ` style()`, ` QStyle`, ` setPalette()` und ` desktopSettingsAware()`.

[static] QStyle *QApplication::setStyle(const QString &style)

Fordert ein „ QStyle “-Objekt für „ style “ von „ QStyleFactory “ an.

Die Zeichenfolge muss einer der Werte von ` QStyleFactory::keys()` entsprechen, typischerweise „windows“, „windowsvista“, „fusion“ oder „macos“. Bei den Stilnamen wird die Groß-/Kleinschreibung nicht berücksichtigt.

Gibt „ nullptr “ zurück, wenn eine unbekannte „ style “ übergeben wird; andernfalls wird das zurückgegebene „ QStyle “-Objekt als GUI-Stil der Anwendung festgelegt.

[static] QStyle *QApplication::style()

Gibt das Stilobjekt der Anwendung zurück.

Siehe auch „ setStyle()“ und „ QStyle “.

[static] QWidget *QApplication::topLevelAt(const QPoint &point)

Gibt das Widget der obersten Ebene an der angegebenen Adresse ` point` zurück; gibt ` nullptr ` zurück, wenn kein solches Widget vorhanden ist.

[static] QWidget *QApplication::topLevelAt(int x, int y)

Gibt das Widget der obersten Ebene an der Position (x, y) zurück; gibt 0 zurück, wenn kein solches Widget vorhanden ist.

[static] QWidgetList QApplication::topLevelWidgets()

Gibt eine Liste der Widgets der obersten Ebene (Fenster) in der Anwendung zurück.

Beispiel:

void showAllHiddenTopLevelWidgets()
{
    const QWidgetList topLevelWidgets = QApplication::topLevelWidgets();
    for (QWidget *widget : topLevelWidgets) {
        if (widget->isHidden())
            widget->show();
    }
}

Siehe auch „ allWidgets()“, „ QWidget::isWindow()“ und „ QWidget::isHidden()“.

[static] QWidget *QApplication::widgetAt(const QPoint &point)

Gibt das Widget an der globalen Bildschirmposition „ point “ zurück oder „ nullptr “, falls sich dort kein Qt-Widget befindet.

Diese Funktion kann langsam sein.

Siehe auch QCursor::pos(), QWidget::grabMouse() und QWidget::grabKeyboard().

[static] QWidget *QApplication::widgetAt(int x, int y)

Gibt das Widget an der globalen Bildschirmposition zurück (x, y) oder nullptr, falls sich dort kein Qt-Widget befindet.