QtAndroidPrivate Namespace
Der Namespace „QtAndroidPrivate“ bietet verschiedene Funktionen, die die Android-Entwicklung erleichtern. Mehr...
| Header: | #include <QtCore/private/qandroidextras_p.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CorePrivate) target_link_libraries(mytarget PRIVATE Qt6::CorePrivate) |
| qmake: | QT += core-private |
| Seit: | Qt 6.2 |
| Status: | Technologievorschau |
Dieser Namensraum befindet sich in der Technologievorschau und kann sich noch ändern.
Typen
(since 6.2) enum class | BindFlag { None, AutoCreate, DebugUnbind, NotForeground, AboveClient, …, ExternalService } |
| flags | BindFlags |
Funktionen
(since 6.2) bool | bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None) |
(technology preview) QFuture<QtAndroidPrivate::PermissionResult> | checkPermission(const QString &permission) |
(technology preview) QFuture<QtAndroidPrivate::PermissionResult> | requestPermission(const QString &permission) |
(since 6.2) void | startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr) |
(since 6.2) void | startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr) |
(since 6.2) void | startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc) |
(since 6.2) void | startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr) |
Typdokumentation
[since 6.2] enum class QtAndroidPrivate::BindFlag
flags QtAndroidPrivate::BindFlags
Diese Enumeration wird zusammen mit ` QtAndroidPrivate::bindService ` verwendet, um den Modus zu beschreiben, in dem die Bindung erfolgt.
| Konstante | Wert | Beschreibung |
|---|---|---|
QtAndroidPrivate::BindFlag::None | 0x00000000 | Keine Optionen. |
QtAndroidPrivate::BindFlag::AutoCreate | 0x00000001 | Erstellt den Dienst automatisch, solange die Bindung besteht. Weitere Details finden Sie in der Dokumentation zu BIND_AUTO_CREATE. |
QtAndroidPrivate::BindFlag::DebugUnbind | 0x00000002 | Fügt Debugging-Hilfe für nicht übereinstimmende Aufrufe zum Aufheben der Bindung hinzu. Weitere Details finden Sie in der Dokumentation zu BIND_DEBUG_UNBIND. |
QtAndroidPrivate::BindFlag::NotForeground | 0x00000004 | Verhindert, dass diese Bindung den Prozess des Ziel-Dienstes auf die Priorität „Vordergrund“ erhöht. Weitere Details finden Sie in der Dokumentation zu BIND_NOT_FOREGROUND. |
QtAndroidPrivate::BindFlag::AboveClient | 0x00000008 | Gibt an, dass die Client-Anwendung, die eine Bindung an diesen Dienst herstellt, den Dienst als wichtiger als die Anwendung selbst betrachtet. Weitere Details finden Sie in der Dokumentation zu BIND_ABOVE_CLIENT. |
QtAndroidPrivate::BindFlag::AllowOomManagement | 0x00000010 | Erlaubt dem Prozess, der den gebundenen Dienst hostet, seine normale Speicherverwaltung durchzuführen. Weitere Details finden Sie in der Dokumentation zu BIND_ALLOW_OOM_MANAGEMENT. |
QtAndroidPrivate::BindFlag::WaivePriority | 0x00000020 | Die Priorität des Host-Prozesses des Zieldienstes hinsichtlich der Ablaufplanung oder Speicherverwaltung wird nicht beeinflusst. Weitere Details finden Sie in der Dokumentation zu BIND_WAIVE_PRIORITY. |
QtAndroidPrivate::BindFlag::Important | 0x00000040 | Diesem Dienst wird eine höhere Priorität zugewiesen, damit er dem Client bei Bedarf zur Verfügung steht. Weitere Informationen finden Sie in der Dokumentation zu BIND_IMPORTANT. |
QtAndroidPrivate::BindFlag::AdjustWithActivity | 0x00000080 | Bei der Bindung aus einer Aktivität heraus wird zugelassen, dass die Prozesswichtigkeit des Zieldienstes erhöht wird, je nachdem, ob die Aktivität für den Benutzer sichtbar ist. Weitere Details finden Sie in der Dokumentation zu BIND_ADJUST_WITH_ACTIVITY. |
QtAndroidPrivate::BindFlag::ExternalService | -2147483648 | Bei dem zu bindenden Dienst handelt es sich um einen isolierten, externen Dienst. Weitere Informationen finden Sie in der Dokumentation zu BIND_EXTERNAL_SERVICE. |
Diese Enumeration wurde in Qt 6.2 eingeführt.
Der Typ „BindFlags“ ist ein „typedef“ für „QFlags<BindFlag>“. Er speichert eine ODER-Kombination von „BindFlag“-Werten.
Funktionsdokumentation
[since 6.2] bool QtAndroidPrivate::bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None)
Bindet den unter serviceIntent, serviceConnection und flags bereitgestellten Dienst. Das Objekt „ serviceIntent “ identifiziert den Dienst, zu dem eine Verbindung hergestellt werden soll. „ serviceConnection “ ist ein Listener, der Informationen zum Starten und Beenden des Dienstes empfängt.
Gibt bei Erfolg „true“ zurück
Weitere Details finden Sie in der Android-Dokumentation.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch QAndroidIntent, QAndroidServiceConnection und BindFlag.
[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::checkPermission(const QString &permission)
Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.
Prüft, ob dieser Prozess über die angegebene Berechtigung „ permission “ verfügt, und gibt einen „ QFuture “ zurück, der das Ergebnis der Prüfung darstellt.
Hinweis: „ QPermission “ ist die empfohlene API zum Anfordern von Berechtigungen. Falls „ QPermission “ eine von Ihnen angeforderte Android-Berechtigung nicht abdeckt, kann stattdessen weiterhin diese vorläufige API verwendet werden.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch requestPermission().
[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::requestPermission(const QString &permission)
Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.
Fordert die „ permission “ an und gibt eine „ QFuture “ zurück, die das Ergebnis der Anfrage darstellt.
Hinweis: „ QPermission “ ist die empfohlene API zum Anfordern von Berechtigungen. Falls „ QPermission “ eine von Ihnen angeforderte Android-Berechtigung nicht abdeckt, kann stattdessen weiterhin diese vorläufige API verwendet werden.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch checkPermission().
[since 6.2] void QtAndroidPrivate::startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Startet die durch „ intent “ angegebene Aktivität und liefert das Ergebnis asynchron über „ resultReceiver “, sofern dieser Wert nicht null ist.
Ist ` resultReceiver ` null, wird die Methode ` startActivity() ` von ` QNativeInterface::QAndroidApplication::context()` aufgerufen. Andernfalls wird ` startActivityForResult() ` aufgerufen.
receiverRequestCode ist ein für resultReceiver eindeutiger Anforderungscode, der zusammen mit dem Ergebnis zurückgegeben wird, wodurch es möglich ist, denselben Empfänger für mehr als eine Absicht zu verwenden.
Diese Funktion wurde in Qt 6.2 eingeführt.
[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Startet die durch „ intent “ angegebene Aktivität und liefert das Ergebnis asynchron über „ resultReceiver “, sofern dieser Wert nicht null ist.
Ist ` resultReceiver ` null, wird die Methode ` startActivity() ` von ` QNativeInterface::QAndroidApplication::context()` aufgerufen. Andernfalls wird ` startActivityForResult() ` aufgerufen.
receiverRequestCode ist ein für resultReceiver eindeutiger Anforderungscode, der zusammen mit dem Ergebnis zurückgegeben wird, wodurch es möglich ist, denselben Empfänger für mehr als eine Absicht zu verwenden.
Diese Funktion wurde in Qt 6.2 eingeführt.
[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc)
Startet die unter intent angegebene Aktivität unter Verwendung des Anforderungscodes receiverRequestCode und liefert das Ergebnis durch Aufruf von callbackFunc.
Diese Funktion wurde in Qt 6.2 eingeführt.
[since 6.2] void QtAndroidPrivate::startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Startet die durch ` intentSender ` angegebene Aktivität und liefert das Ergebnis asynchron über ` resultReceiver `, sofern dieser Wert nicht null ist.
Ist ` resultReceiver ` null, wird die Methode ` startIntentSender() ` von ` QNativeInterface::QAndroidApplication::context()` aufgerufen. Andernfalls wird ` startIntentSenderForResult() ` aufgerufen.
receiverRequestCode ist ein für „ resultReceiver “ eindeutiger Anforderungscode, der zusammen mit dem Ergebnis zurückgegeben wird, wodurch es möglich ist, denselben Empfänger für mehr als eine Absicht zu verwenden.
Diese Funktion wurde in Qt 6.2 eingeführt.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
