QCoreApplication Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Qt Core-Anwendung. Kernanwendungen sind Anwendungen ohne grafische Benutzeroberfläche. Solche Anwendungen werden auf der Konsole oder als Serverprozesse verwendet.

Die Argumente argc und argv werden von der Anwendung verarbeitet und in einer bequemeren Form von der Funktion arguments() zur Verfügung gestellt.

[virtual noexcept] QCoreApplication::~QCoreApplication()

Zerstört das Objekt QCoreApplication.

[private signal] void QCoreApplication::aboutToQuit()

Dieses Signal wird ausgegeben, wenn die Anwendung im Begriff ist, die Hauptereignisschleife zu beenden, z. B. wenn der Pegel der Ereignisschleife auf Null fällt. Dies kann entweder nach einem Aufruf von quit() innerhalb der Anwendung geschehen oder wenn der Benutzer die gesamte Desktop-Sitzung beendet.

Das Signal ist besonders nützlich, wenn Ihre Anwendung in letzter Sekunde aufräumen muss. Beachten Sie, dass in diesem Zustand keine Benutzerinteraktion möglich ist.

Siehe auch quit().

[static] void QCoreApplication::addLibraryPath(const QString &path)

Stellt path an den Anfang der Bibliothekspfadliste, um sicherzustellen, dass zuerst nach Bibliotheken gesucht wird. Wenn path leer ist oder sich bereits in der Pfadliste befindet, wird die Pfadliste nicht geändert.

Die Standardpfadliste besteht aus einem oder zwei Einträgen. Der erste ist das Installationsverzeichnis für Plugins, also INSTALL/plugins, wobei INSTALL das Verzeichnis ist, in dem Qt installiert wurde. Der zweite ist das eigene Verzeichnis der Anwendung(nicht das aktuelle Verzeichnis), aber nur nachdem das QCoreApplication Objekt instanziiert wurde.

Die Bibliothekspfade werden auf den Standard zurückgesetzt, wenn eine Instanz von QCoreApplication zerstört wird.

Siehe auch removeLibraryPath(), libraryPaths(), und setLibraryPaths().

[static] QString QCoreApplication::applicationDirPath()

Gibt das Verzeichnis zurück, das die ausführbare Datei der Anwendung enthält.

Wenn Sie zum Beispiel Qt im Verzeichnis C:\Qt installiert haben und das Beispiel regexp ausführen, gibt diese Funktion "C:/Qt/examples/tools/regexp" zurück.

Unter macOS und iOS verweist dies auf das Verzeichnis, das die ausführbare Datei enthält, die sich in einem Anwendungsbündel befinden kann (wenn die Anwendung gebündelt ist).

Siehe auch applicationFilePath().

[static] QString QCoreApplication::applicationFilePath()

Gibt den Dateipfad der ausführbaren Datei der Anwendung zurück.

Wenn Sie zum Beispiel Qt im Verzeichnis /usr/local/qt installiert haben und das Beispiel regexp ausführen, gibt diese Funktion "/usr/local/qt/examples/tools/regexp/regexp" zurück.

Siehe auch applicationDirPath().

[static] qint64 QCoreApplication::applicationPid()

Gibt die aktuelle Prozess-ID für die Anwendung zurück.

[static] QStringList QCoreApplication::arguments()

Gibt die Liste der Befehlszeilenargumente zurück.

Normalerweise ist arguments().at(0) der Programmname, arguments().at(1) ist das erste Argument und arguments().last() ist das letzte Argument. Siehe den Hinweis unten über Windows.

Der Aufruf dieser Funktion ist langsam - Sie sollten das Ergebnis in einer Variablen speichern, wenn Sie die Befehlszeile parsen.

Unter Windows wird die Liste nur dann aus den argc- und argv-Parametern erstellt, wenn modifizierte argv/argc-Parameter an den Konstruktor übergeben werden. In diesem Fall kann es zu Kodierungsproblemen kommen.

Andernfalls werden die Argumente() aus dem Rückgabewert von GetCommandLine() gebildet. Dies hat zur Folge, dass die von arguments().at(0) angegebene Zeichenkette unter Windows möglicherweise nicht der Programmname ist, je nachdem, wie die Anwendung gestartet wurde.

Siehe auch applicationFilePath() und QCommandLineParser.

[since 6.5] Qt::PermissionStatus QCoreApplication::checkPermission(const QPermission &permission)

Überprüft den Status der angegebenen permission

Wenn das Ergebnis Qt::PermissionStatus::Undetermined ist, sollte die Erlaubnis über requestPermission() angefordert werden, um die Absicht des Benutzers zu bestimmen.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch requestPermission() und Application Permissions.

[static] bool QCoreApplication::closingDown()

Gibt true zurück, wenn die Anwendungsobjekte zerstört werden; andernfalls wird false zurückgegeben.

Siehe auch startingUp().

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

Reimplements: QObject::event(QEvent *e).

[static] QAbstractEventDispatcher *QCoreApplication::eventDispatcher()

Gibt einen Zeiger auf das Event-Dispatcher-Objekt für den Haupt-Thread zurück. Wenn kein Event-Dispatcher für den Thread existiert, gibt diese Funktion nullptr zurück.

Siehe auch setEventDispatcher().

[static] int QCoreApplication::exec()

Tritt in die Hauptereignisschleife ein und wartet, bis exit() aufgerufen wird. Gibt den Wert zurück, der an exit() übergeben wurde (der 0 ist, wenn exit() über quit() aufgerufen wird).

Es ist notwendig, diese Funktion aufzurufen, um die Ereignisbehandlung zu starten. Die Hauptereignisschleife empfängt Ereignisse vom Fenstersystem und gibt diese an die Anwendungswidgets weiter.

Damit Ihre Anwendung eine Leerlaufverarbeitung durchführt (indem eine spezielle Funktion immer dann ausgeführt wird, wenn keine Ereignisse anstehen), verwenden Sie eine QChronoTimer mit 0ns Timeout. Fortschrittlichere Leerlaufverarbeitungsschemata können mit processEvents() erreicht werden.

Wir empfehlen Ihnen, den Aufräumcode mit dem Signal aboutToQuit() zu verbinden, anstatt ihn in die Funktion main() Ihrer Anwendung zu integrieren, da auf einigen Plattformen der Aufruf exec() möglicherweise nicht zurückkehrt. Wenn sich der Benutzer beispielsweise unter Windows abmeldet, beendet das System den Prozess, nachdem Qt alle Fenster der obersten Ebene geschlossen hat. Daher gibt es keine Garantie, dass die Anwendung nach dem exec()-Aufruf Zeit hat, ihre Ereignisschleife zu verlassen und Code am Ende der Funktion main() auszuführen.

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

[static slot] void QCoreApplication::exit(int returnCode = 0)

Weist die Anwendung an, sich mit einem Rückgabewert zu beenden.

Nach dem Aufruf dieser Funktion verlässt die Anwendung die Hauptereignisschleife und kehrt vom Aufruf der Funktion exec() zurück. Die Funktion exec() gibt returnCode zurück. Wenn die Ereignisschleife nicht läuft, führt diese Funktion nichts aus.

Konventionell bedeutet ein returnCode von 0 Erfolg, und jeder Wert ungleich Null bedeutet einen Fehler.

Es ist eine gute Praxis, Signale immer über QueuedConnection mit diesem Slot zu verbinden. Wenn ein mit diesem Slot verbundenes (nicht in eine Warteschlange gestelltes) Signal ausgegeben wird, bevor die Kontrolle in die Hauptereignisschleife eintritt (z. B. bevor "int main" exec() aufruft), hat der Slot keine Wirkung und die Anwendung wird nie beendet. Die Verwendung einer Warteschlangenverbindung stellt sicher, dass der Slot erst aufgerufen wird, nachdem die Steuerung in die Hauptereignisschleife eingetreten ist.

Beachten Sie, dass diese Funktion im Gegensatz zur gleichnamigen Funktion der C-Bibliothek zum Aufrufer zurückkehrt - die Ereignisverarbeitung wird angehalten.

Beachten Sie auch, dass diese Funktion nicht thread-sicher ist. Sie sollte nur vom Haupt-Thread aus aufgerufen werden (dem Thread, in dem das Objekt QCoreApplication Ereignisse verarbeitet). Um die Anwendung von einem anderen Thread aus zum Beenden aufzufordern, verwenden Sie entweder QCoreApplication::quit() oder rufen Sie diese Funktion stattdessen vom Hauptthread aus mit QMetaMethod::invokeMethod() auf.

Siehe auch quit() und exec().

void QCoreApplication::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)

Installiert einen Ereignisfilter filterObj für alle nativen Ereignisse, die von der Anwendung im Hauptthread empfangen werden.

Der Ereignisfilter filterObj empfängt Ereignisse über seine Funktion nativeEventFilter(), die für alle nativen Ereignisse aufgerufen wird, die im Haupt-Thread empfangen werden.

Die Funktion QAbstractNativeEventFilter::nativeEventFilter() sollte true zurückgeben, wenn das Ereignis gefiltert, d.h. gestoppt werden soll. Sie sollte false zurückgeben, damit die normale Qt-Verarbeitung fortgesetzt werden kann: Das native Ereignis kann dann in ein QEvent übersetzt und durch die Standard-Qt event Filterung, z.B. QObject::installEventFilter(), behandelt werden.

Wenn mehrere Ereignisfilter installiert sind, wird der zuletzt installierte Filter zuerst aktiviert.

Für maximale Portabilität sollten Sie immer versuchen, QEvent und QObject::installEventFilter() zu verwenden, wann immer dies möglich ist.

Siehe auch QObject::installEventFilter().

[static] bool QCoreApplication::installTranslator(QTranslator *translationFile)

Fügt die Übersetzungsdatei translationFile in die Liste der Übersetzungsdateien ein, die für Übersetzungen verwendet werden sollen.

Es können mehrere Übersetzungsdateien installiert werden. Es wird in der umgekehrten Reihenfolge der Installation nach Übersetzungen gesucht, d.h. die zuletzt installierte Übersetzungsdatei wird zuerst durchsucht und die erste installierte Übersetzungsdatei wird zuletzt durchsucht. Die Suche wird abgebrochen, sobald eine Übersetzung gefunden wird, die eine passende Zeichenfolge enthält.

Das Installieren oder Entfernen einer QTranslator, oder das Ändern einer installierten QTranslator erzeugt ein LanguageChange Ereignis für die QCoreApplication Instanz. Eine QApplication Instanz wird das Ereignis an alle Toplevel-Widgets weitergeben, wo eine Neuimplementierung von changeEvent die Benutzeroberfläche neu übersetzen kann, indem sie für den Benutzer sichtbare Zeichenketten über die Funktion tr() an die entsprechenden Eigenschaftssetzer weitergibt. Von Qt Widgets Designer generierte Benutzeroberflächenklassen bieten eine retranslateUi() Funktion, die aufgerufen werden kann.

Die Funktion gibt im Erfolgsfall true und im Fehlerfall false zurück.

Siehe auch removeTranslator(), translate(), QTranslator::load(), und Vorbereiten auf dynamische Sprachänderungen.

[static noexcept] QCoreApplication *QCoreApplication::instance()

Gibt einen Zeiger auf die Instanz QCoreApplication (oder QGuiApplication/QApplication) der Anwendung zurück.

Wenn keine Instanz zugewiesen wurde, wird nullptr zurückgegeben.

[static] bool QCoreApplication::isSetuidAllowed()

Gibt true zurück, wenn die Anwendung auf UNIX-Plattformen setuid ausführen darf.

Siehe auch QCoreApplication::setSetuidAllowed().

[static] QStringList QCoreApplication::libraryPaths()

Gibt eine Liste von Pfaden zurück, die die Anwendung beim dynamischen Laden von Bibliotheken durchsuchen wird.

Der Rückgabewert dieser Funktion kann sich ändern, wenn eine QCoreApplication erstellt wird. Es wird nicht empfohlen, sie vor der Erstellung einer QCoreApplication aufzurufen. Das Verzeichnis der ausführbaren Anwendung(nicht das Arbeitsverzeichnis) ist Teil der Liste, wenn es bekannt ist. Um es bekannt zu machen, muss ein QCoreApplication erstellt werden, da es argv[0] verwendet, um es zu finden.

Qt stellt Standard-Bibliotheks-Pfade zur Verfügung, aber sie können auch über eine qt.conf-Datei festgelegt werden. Pfade, die in dieser Datei angegeben werden, überschreiben die Standardwerte. Beachten Sie, dass die Datei qt.conf, wenn sie sich im Verzeichnis der ausführbaren Anwendung befindet, möglicherweise nicht gefunden wird, bis eine QCoreApplication erstellt wird. Wenn sie beim Aufruf dieser Funktion nicht gefunden wird, werden die Standard-Bibliotheks-Pfade verwendet.

Die Liste enthält das Installationsverzeichnis für Plugins, falls es existiert (das Standard-Installationsverzeichnis für Plugins ist INSTALL/plugins, wobei INSTALL das Verzeichnis ist, in dem Qt installiert wurde). Die durch Doppelpunkte getrennten Einträge der Umgebungsvariablen QT_PLUGIN_PATH werden immer hinzugefügt. Das Plugin-Installationsverzeichnis (und dessen Existenz) kann sich ändern, wenn das Verzeichnis der ausführbaren Anwendung bekannt wird.

Siehe auch setLibraryPaths(), addLibraryPath(), removeLibraryPath(), QLibrary, und How to Create Qt Plugins.

[virtual] bool QCoreApplication::notify(QObject *receiver, QEvent *event)

Sendet event an receiver: receiver->event(event). Gibt den Wert zurück, der vom Ereignis-Handler des Empfängers zurückgegeben wird. Beachten Sie, dass diese Funktion für alle Ereignisse aufgerufen wird, die an ein beliebiges Objekt in einem beliebigen Thread gesendet werden.

Bei bestimmten Ereignistypen (z. B. Maus- und Tastenereignissen) wird das Ereignis an das übergeordnete Objekt des Empfängers weitergegeben und so weiter bis zum obersten Objekt, wenn der Empfänger nicht an dem Ereignis interessiert ist (d. h. es wird false zurückgegeben).

Es gibt fünf verschiedene Möglichkeiten, wie Ereignisse verarbeitet werden können; die Neuimplementierung dieser virtuellen Funktion ist nur eine von ihnen. Alle fünf Ansätze sind unten aufgeführt:

1. Neuimplementierung von paintEvent(), mousePressEvent() und so weiter. Dies ist der häufigste, einfachste und am wenigsten leistungsfähige Weg.
2. Neuimplementierung dieser Funktion. Dies ist sehr leistungsfähig und bietet vollständige Kontrolle; allerdings kann nur eine Unterklasse gleichzeitig aktiv sein.
3. Installieren eines Ereignisfilters auf QCoreApplication::instance(). Ein solcher Ereignisfilter ist in der Lage, alle Ereignisse für alle Widgets zu verarbeiten, so dass er genauso leistungsfähig ist wie die Neuimplementierung von notify(); darüber hinaus ist es möglich, mehr als einen anwendungsglobalen Ereignisfilter zu haben. Globale Ereignisfilter sehen sogar Mausereignisse für disabled widgets. Beachten Sie, dass Anwendungs-Ereignisfilter nur für Objekte aufgerufen werden, die sich im Haupt-Thread befinden.
4. Neuimplementierung von QObject::event() (wie QWidget ). Wenn Sie dies tun, erhalten Sie das Drücken der Tabulatortaste, und Sie sehen die Ereignisse vor allen widget-spezifischen Ereignisfiltern.
5. Installieren eines Ereignisfilters für das Objekt. Ein solcher Ereignisfilter erhält alle Ereignisse, einschließlich der Tabulator- und Umschalt+Tabulator-Tastendruck-Ereignisse, solange sie nicht das Fokus-Widget ändern.

Zukünftige Richtung: Diese Funktion wird in Qt 7 nicht mehr für Objekte aufgerufen, die sich außerhalb des Haupt-Threads befinden. Anwendungen, die diese Funktionalität benötigen, sollten in der Zwischenzeit andere Lösungen für ihre Bedürfnisse bei der Ereignisüberprüfung finden. Die Änderung kann auf den Haupt-Thread ausgeweitet werden, wodurch diese Funktion veraltet wird.

Siehe auch QObject::event() und installNativeEventFilter().

[static] void QCoreApplication::postEvent(QObject *receiver, QEvent *event, int priority = Qt::NormalEventPriority)

Fügt das Ereignis event mit dem Objekt receiver als Empfänger des Ereignisses zu einer Ereigniswarteschlange hinzu und kehrt sofort zurück.

Das Ereignis muss auf dem Heap zugewiesen werden, da die Post-Event-Warteschlange das Eigentum an dem Ereignis übernimmt und es löscht, sobald es gesendet wurde. Es ist nicht sicher, auf das Ereignis zuzugreifen, nachdem es gepostet wurde.

Wenn die Kontrolle zur Hauptereignisschleife zurückkehrt, werden alle Ereignisse, die in der Warteschlange gespeichert sind, mit der Funktion notify() gesendet.

Die Ereignisse werden in absteigender priority Reihenfolge sortiert, d.h. Ereignisse mit einem hohen priority werden vor Ereignissen mit einem niedrigeren priority in die Warteschlange gestellt. Der priority kann ein beliebiger ganzzahliger Wert sein, d. h. zwischen INT_MAX und INT_MIN, einschließlich; siehe Qt::EventPriority für weitere Einzelheiten. Ereignisse mit gleichem priority werden in der angegebenen Reihenfolge verarbeitet.

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch sendEvent(), notify(), sendPostedEvents(), und Qt::EventPriority.

[static] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents)

Verarbeitet einige anstehende Ereignisse für den aufrufenden Thread gemäß der angegebenen flags.

Von der Verwendung dieser Funktion wird abgeraten. Ziehen Sie es stattdessen vor, lange Operationen aus dem GUI-Thread in einen Hilfsthread zu verlagern und die Verarbeitung in verschachtelten Ereignisschleifen vollständig zu vermeiden. Wenn eine Ereignisverarbeitung wirklich notwendig ist, sollten Sie stattdessen QEventLoop verwenden.

Falls Sie eine lokale Schleife ausführen, die diese Funktion kontinuierlich aufruft, werden die DeferredDelete Ereignisse ohne Ereignisschleife nicht verarbeitet. Dies kann sich auf das Verhalten von Widgets, z. B. QToolTip, auswirken, die auf DeferredDelete Ereignisse angewiesen sind, um ordnungsgemäß zu funktionieren. Eine Alternative wäre der Aufruf von sendPostedEvents() innerhalb dieser lokalen Schleife.

Der Aufruf dieser Funktion verarbeitet Ereignisse nur für den aufrufenden Thread und kehrt zurück, nachdem alle verfügbaren Ereignisse verarbeitet wurden. Verfügbare Ereignisse sind Ereignisse, die vor dem Funktionsaufruf in der Warteschlange stehen. Das bedeutet, dass Ereignisse, die während der Ausführung der Funktion gebucht werden, bis zu einer späteren Runde der Ereignisverarbeitung in die Warteschlange gestellt werden.

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch exec(), QTimer, QChronoTimer, QEventLoop::processEvents(), und sendPostedEvents().

[static, since 6.7] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline)

Dies ist eine überladene Funktion.

Verarbeitet anstehende Ereignisse für den aufrufenden Thread, bis deadline abgelaufen ist oder bis es keine weiteren Ereignisse mehr zu verarbeiten gibt, je nachdem, was zuerst eintritt.

Von der Verwendung dieser Funktion wird abgeraten. Ziehen Sie es stattdessen vor, lange Operationen aus dem GUI-Thread in einen Hilfsthread zu verlagern und die Verarbeitung in verschachtelten Ereignisschleifen vollständig zu vermeiden. Wenn die Verarbeitung von Ereignissen wirklich notwendig ist, sollten Sie stattdessen QEventLoop verwenden.

Der Aufruf dieser Funktion verarbeitet Ereignisse nur für den aufrufenden Thread.

Hinweis: Diese Funktion ist thread-sicher.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch exec(), QTimer, QChronoTimer, und QEventLoop::processEvents().

[static] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags, int ms)

Dies ist eine überladene Funktion.

Verarbeitet anstehende Ereignisse für den aufrufenden Thread für ms Millisekunden oder bis keine weiteren Ereignisse mehr zu verarbeiten sind, je nachdem, was kürzer ist.

Dies ist gleichbedeutend mit einem Aufruf:

QCoreApplication::processEvents(flags, QDeadlineTimer(ms));

[static slot] void QCoreApplication::quit()

Fordert die Anwendung zum Beenden auf.

Die Aufforderung kann ignoriert werden, wenn die Anwendung das Beenden verhindert, z. B. wenn eines ihrer Fenster nicht geschlossen werden kann. Die Anwendung kann dies beeinflussen, indem sie das Ereignis QEvent::Quit auf der Ebene der Anwendung oder QEvent::Close für die einzelnen Fenster behandelt.

Wenn das Beenden nicht unterbrochen wird, wird die Anwendung mit dem Rückgabewert 0 (Erfolg) beendet.

Um die Anwendung zu beenden, ohne dass die Möglichkeit besteht, unterbrochen zu werden, rufen Sie exit() direkt auf. Beachten Sie, dass diese Methode nicht thread-sicher ist.

Es ist eine gute Praxis, Signale immer über QueuedConnection mit diesem Slot zu verbinden. Wenn ein mit diesem Slot verbundenes (nicht in eine Warteschlange gestelltes) Signal ausgegeben wird, bevor die Kontrolle in die Hauptereignisschleife eintritt (z. B. bevor "int main" exec() aufruft), hat der Slot keine Wirkung und die Anwendung wird nie beendet. Die Verwendung einer Warteschlangenverbindung stellt sicher, dass der Slot erst aufgerufen wird, nachdem die Steuerung in die Hauptereignisschleife eingetreten ist.

Beispiel:

QPushButton *quitButton = new QPushButton("Quit");
connect(quitButton, &QPushButton::clicked, &app, &QCoreApplication::quit, Qt::QueuedConnection);

Hinweis zur Thread-Sicherheit: Diese Funktion kann von jedem Thread aus aufgerufen werden, um die aktuell laufende Hauptanwendungsschleife thread-sicher zu beenden. Die Thread-Sicherheit ist jedoch nicht gewährleistet, wenn das Objekt QCoreApplication zur gleichen Zeit zerstört wird.

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch exit() und aboutToQuit().

[static] void QCoreApplication::removeLibraryPath(const QString &path)

Entfernt path aus der Pfadliste der Bibliothek. Wenn path leer ist oder sich nicht in der Pfadliste befindet, wird die Liste nicht geändert.

Die Bibliothekspfade werden auf die Standardwerte zurückgesetzt, wenn eine Instanz von QCoreApplication zerstört wird.

Siehe auch addLibraryPath(), libraryPaths(), und setLibraryPaths().

void QCoreApplication::removeNativeEventFilter(QAbstractNativeEventFilter *filterObject)

Entfernt ein Ereignis filterObject von diesem Objekt. Die Anforderung wird ignoriert, wenn ein solcher Ereignisfilter nicht installiert wurde.

Alle Ereignisfilter für dieses Objekt werden automatisch entfernt, wenn das Objekt zerstört wird.

Es ist immer sicher, einen Ereignisfilter zu entfernen, auch während der Aktivierung des Ereignisfilters (d. h. mit der Funktion nativeEventFilter()).

Siehe auch installNativeEventFilter().

[static] void QCoreApplication::removePostedEvents(QObject *receiver, int eventType = 0)

Entfernt alle Ereignisse des angegebenen eventType, die mit postEvent() für receiver gebucht wurden.

Die Ereignisse werden nicht versendet, sondern aus der Warteschlange entfernt. Sie sollten diese Funktion nie aufrufen müssen. Falls Sie sie doch aufrufen, beachten Sie, dass das Töten von Ereignissen dazu führen kann, dass receiver eine oder mehrere Invarianten bricht.

Wenn receiver gleich nullptr ist, werden die Ereignisse von eventType für alle Objekte entfernt. Wenn eventType gleich 0 ist, werden alle Ereignisse für receiver entfernt. Sie sollten diese Funktion niemals aufrufen, wenn eventType gleich 0 ist.

Hinweis: Diese Funktion ist thread-sicher.

[static] bool QCoreApplication::removeTranslator(QTranslator *translationFile)

Entfernt die Übersetzungsdatei translationFile aus der Liste der von dieser Anwendung verwendeten Übersetzungsdateien. (Sie löscht die Übersetzungsdatei nicht aus dem Dateisystem.)

Die Funktion gibt bei Erfolg true und bei einem Fehler false zurück.

Siehe auch installTranslator(), translate(), und QObject::tr().

[since 6.5] template <typename Functor> void QCoreApplication::requestPermission(const QPermission &permission, Functor &&functor)

Fordert die angegebene permission an.

Wenn die Anfrage fertig ist, wird functor als functor(const QPermission &permission) aufgerufen, wobei permission das Ergebnis der Anfrage beschreibt.

Die functor kann eine eigenständige oder statische Mitgliedsfunktion sein:

qApp->requestPermission(QCameraPermission{}, &permissionUpdated);

oder ein Lambda:

qApp->requestPermission(QCameraPermission{}, [](const QPermission &permission) {
});

Wenn der Benutzer der Anwendung die angeforderte permission ausdrücklich gewährt oder permission bekannt ist, dass die Benutzerautorisierung auf der gegebenen Plattform nicht erforderlich ist, wird der Status Qt::PermissionStatus::Granted sein.

Wenn der Benutzer der Anwendung die angeforderte permission ausdrücklich verweigert oder die permission bekanntermaßen für Anwendungen auf der gegebenen Plattform nicht zugänglich oder anwendbar ist, lautet der Status Qt::PermissionStatus::Denied.

Das Ergebnis einer Anfrage wird niemals Qt::PermissionStatus::Undetermined sein.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch checkPermission() und Application Permissions.

[since 6.5] template <typename Functor> void QCoreApplication::requestPermission(const QPermission &permission, const QObject *context, Functor functor)

Fordert die angegebene permission an, im Kontext von context.

Wenn die Anfrage fertig ist, wird functor als functor(const QPermission &permission) aufgerufen, wobei permission das Ergebnis der Anfrage beschreibt.

Die functor kann eine eigenständige oder statische Mitgliedsfunktion sein:

qApp->requestPermission(QCameraPermission{}, context, &permissionUpdated);

Ein Lambda:

qApp->requestPermission(QCameraPermission{}, context, [](const QPermission &permission) {
});

oder ein Slot im context Objekt:

qApp->requestPermission(QCameraPermission{}, this, &CamerWidget::permissionUpdated);

Die functor wird im Thread des context Objekts aufgerufen. Wenn context zerstört wird, bevor die Anfrage abgeschlossen ist, wird functor nicht aufgerufen.

Gewährt der Benutzer der Anwendung ausdrücklich die angeforderte permission, oder ist bekannt, dass permission auf der gegebenen Plattform keine Benutzerautorisierung erfordert, lautet der Status Qt::PermissionStatus::Granted.

Wenn der Benutzer der Anwendung die angeforderte permission ausdrücklich verweigert oder die permission bekanntermaßen für Anwendungen auf der gegebenen Plattform nicht zugänglich oder anwendbar ist, lautet der Status Qt::PermissionStatus::Denied.

Das Ergebnis einer Anfrage wird niemals Qt::PermissionStatus::Undetermined sein.

Dies ist eine überladene Funktion.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch checkPermission() und Application Permissions.

[static] bool QCoreApplication::sendEvent(QObject *receiver, QEvent *event)

Sendet das Ereignis event direkt an den Verbraucher receiver, unter Verwendung der Funktion notify(). Gibt den Wert zurück, der vom Ereignishandler zurückgegeben wurde.

Das Ereignis wird nicht gelöscht, wenn das Ereignis gesendet wurde. Normalerweise wird das Ereignis z. B. auf dem Stack erzeugt:

QMouseEvent event(QEvent::MouseButtonPress, pos, 0, 0, 0);
QApplication::sendEvent(mainWindow, &event);

Siehe auch postEvent() und notify().

[static] void QCoreApplication::sendPostedEvents(QObject *receiver = nullptr, int event_type = 0)

Versendet sofort alle Ereignisse, die zuvor mit QCoreApplication::postEvent() in die Warteschlange gestellt wurden und die sich auf das Objekt receiver beziehen und den Ereignistyp event_type haben.

Ereignisse aus dem Fenstersystem werden nicht von dieser Funktion, sondern von processEvents() verschickt.

Wenn receiver gleich nullptr ist, werden die Ereignisse von event_type für alle Objekte gesendet. Wenn event_type gleich 0 ist, werden alle Ereignisse für receiver gesendet.

Siehe auch postEvent().

[static] void QCoreApplication::setAttribute(Qt::ApplicationAttribute attribute, bool on = true)

Setzt das Attribut attribute, wenn on wahr ist; andernfalls wird das Attribut gelöscht.

Siehe auch testAttribute().

[static] void QCoreApplication::setEventDispatcher(QAbstractEventDispatcher *eventDispatcher)

Setzt den Event-Dispatcher für den Hauptthread auf eventDispatcher. Dies ist nur möglich, solange noch kein Event-Dispatcher installiert ist. Das heißt, bevor QCoreApplication instanziiert worden ist. Diese Methode übernimmt das Eigentum an dem Objekt.

Siehe auch eventDispatcher().

[static] void QCoreApplication::setLibraryPaths(const QStringList &paths)

Legt die Liste der zu durchsuchenden Verzeichnisse beim Laden von Plugins mit QLibrary auf paths fest. Alle vorhandenen Pfade werden gelöscht und die Pfadliste besteht aus den in paths angegebenen Pfaden und dem Pfad zur Anwendung.

Die Bibliothekspfade werden auf die Standardwerte zurückgesetzt, wenn eine Instanz von QCoreApplication zerstört wird.

Siehe auch libraryPaths(), addLibraryPath(), removeLibraryPath(), und QLibrary.

[static] void QCoreApplication::setSetuidAllowed(bool allow)

Erlaubt der Anwendung, setuid auf UNIX-Plattformen auszuführen, wenn allow true ist.

Wenn allow falsch ist (Standardeinstellung) und Qt feststellt, dass die Anwendung mit einer effektiven Benutzerkennung läuft, die sich von der tatsächlichen Benutzerkennung unterscheidet, wird die Anwendung abgebrochen, wenn eine QCoreApplication Instanz erstellt wird.

Qt ist aufgrund seiner großen Angriffsfläche keine geeignete Lösung für Setuid-Programme. Einige Anwendungen müssen jedoch aus historischen Gründen auf diese Weise ausgeführt werden. Dieses Flag verhindert, dass Qt die Anwendung abbricht, wenn dies erkannt wird, und muss gesetzt werden, bevor eine QCoreApplication Instanz erstellt wird.

Siehe auch isSetuidAllowed().

[static] bool QCoreApplication::startingUp()

Gibt true zurück, wenn noch kein Anwendungsobjekt erstellt wurde; andernfalls wird false zurückgegeben.

Siehe auch closingDown().

[static] bool QCoreApplication::testAttribute(Qt::ApplicationAttribute attribute)

Gibt true zurück, wenn das Attribut attribute gesetzt ist; andernfalls wird false zurückgegeben.

Siehe auch setAttribute().

[static] QString QCoreApplication::translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1)

Gibt den Übersetzungstext für sourceText zurück, indem die installierten Übersetzungsdateien abgefragt werden. Die Übersetzungsdateien werden von der zuletzt installierten Datei zurück bis zur ersten installierten Datei durchsucht.

QObject::tr() bietet diese Funktionalität auf bequemere Weise.

context ist typischerweise ein Klassenname (z.B. "MyDialog") und sourceText ist entweder englischer Text oder ein kurzer identifizierender Text.

disambiguation ist eine identifizierende Zeichenkette, für den Fall, dass dieselbe sourceText in verschiedenen Rollen innerhalb desselben Kontexts verwendet wird. Standardmäßig ist dies nullptr.

Weitere Informationen über Kontexte, Disambiguierungen und Kommentare finden Sie in der Dokumentation QTranslator und QObject::tr().

n wird in Verbindung mit %n verwendet, um Pluralformen zu unterstützen. Siehe QObject::tr() für Details.

Wenn keine der Übersetzungsdateien eine Übersetzung für sourceText in context enthält, gibt diese Funktion eine QString Entsprechung von sourceText zurück.

Diese Funktion ist nicht virtuell. Sie können alternative Übersetzungstechniken verwenden, indem Sie QTranslator subclassing.

Hinweis: Diese Funktion ist thread-sicher.

Siehe auch QObject::tr(), installTranslator(), removeTranslator(), und Internationalization and Translations.