QtAndroidPrivate Namespace
L'espace de noms QtAndroidPrivate fournit diverses fonctions destinées à faciliter le développement sous Android. En savoir plus...
| En-tête : | #include <QtCore/private/qandroidextras_p.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS CorePrivate) target_link_libraries(mytarget PRIVATE Qt6::CorePrivate) |
| qmake : | QT += core-private |
| Depuis : | Qt 6.2 |
| Statut : | Aperçu technologique |
Cet espace de noms est en avant-première technologique et est susceptible d'être modifié.
Types
(since 6.2) enum class | BindFlag { None, AutoCreate, DebugUnbind, NotForeground, AboveClient, …, ExternalService } |
| flags | BindFlags |
Fonctions
(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) |
Documentation sur les types
[since 6.2] enum class QtAndroidPrivate::BindFlag
flags QtAndroidPrivate::BindFlags
Cette énumération est utilisée avec ` QtAndroidPrivate::bindService ` pour décrire le mode selon lequel la liaison est effectuée.
| Constante | Valeur | Description |
|---|---|---|
QtAndroidPrivate::BindFlag::None | 0x00000000 | Aucune option. |
QtAndroidPrivate::BindFlag::AutoCreate | 0x00000001 | Crée automatiquement le service tant que la liaison existe. Voir la documentation de BIND_AUTO_CREATE pour plus de détails. |
QtAndroidPrivate::BindFlag::DebugUnbind | 0x00000002 | Inclut une aide au débogage pour les appels de déconnexion non correspondants. Consultez la documentation relative à BIND_DEBUG_UNBIND pour plus de détails. |
QtAndroidPrivate::BindFlag::NotForeground | 0x00000004 | Empêche cette liaison de faire passer le processus du service cible à la priorité de planification de premier plan. Consultez la documentation relative à BIND_NOT_FOREGROUND pour plus de détails. |
QtAndroidPrivate::BindFlag::AboveClient | 0x00000008 | Indique que l’application cliente se liant à ce service considère ce dernier comme plus important qu’elle-même. Consultez la documentation relative à BIND_ABOVE_CLIENT pour plus de détails. |
QtAndroidPrivate::BindFlag::AllowOomManagement | 0x00000010 | Autorise le processus hébergeant le service lié à suivre sa gestion normale de la mémoire. Consultez la documentation relative à BIND_ALLOW_OOM_MANAGEMENT pour plus de détails. |
QtAndroidPrivate::BindFlag::WaivePriority | 0x00000020 | N’a pas d’incidence sur la priorité de planification ou de gestion de la mémoire du processus hébergeant le service cible. Consultez la documentation relative à BIND_WAIVE_PRIORITY pour plus de détails. |
QtAndroidPrivate::BindFlag::Important | 0x00000040 | Une priorité plus élevée est attribuée à ce service afin qu’il soit disponible pour le client en cas de besoin. Pour plus d’informations, consultez la documentation relative à BIND_IMPORTANT. |
QtAndroidPrivate::BindFlag::AdjustWithActivity | 0x00000080 | En cas de liaison à partir d’une activité, autoriser l’augmentation de l’importance du processus du service cible en fonction de la visibilité de l’activité pour l’utilisateur. Consultez la documentation relative à BIND_ADJUST_WITH_ACTIVITY pour plus de détails. |
QtAndroidPrivate::BindFlag::ExternalService | -2147483648 | Le service lié est un service externe isolé. Consultez la documentation relative à BIND_EXTERNAL_SERVICE pour plus de détails. |
Cette énumération a été introduite dans Qt 6.2.
Le type `BindFlags` est un `typedef` de ` QFlags<BindFlag>`. Il stocke une combinaison OR de valeurs `BindFlag`.
Documentation de la fonction
[since 6.2] bool QtAndroidPrivate::bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None)
Lie le service fourni par serviceIntent, serviceConnection et flags. L'objet serviceIntent identifie le service auquel se connecter. L'objet serviceConnection est un écouteur qui reçoit les informations relatives au démarrage et à l'arrêt du service.
Renvoie true en cas de succès
Consultez la documentation Android pour plus de détails.
Cette fonction a été introduite dans Qt 6.2.
Voir également QAndroidIntent, QAndroidServiceConnection et BindFlag.
[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::checkPermission(const QString &permission)
Cette fonction est en phase de préversion technique et est susceptible d'être modifiée.
Vérifie si ce processus dispose de l'permission spécifiée et renvoie un QFuture représentant le résultat de la vérification.
Remarque : ` QPermission ` est l’API recommandée pour demander des autorisations. Si ` QPermission ` ne couvre pas une autorisation Android que vous souhaitez demander, cette API préliminaire peut tout de même être utilisée à la place.
Cette fonction a été introduite dans Qt 6.2.
Voir également requestPermission().
[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::requestPermission(const QString &permission)
Cette fonction est en phase de préversion technique et est susceptible d'être modifiée.
Elle demande l'permission et renvoie un QFuture représentant le résultat de la requête.
Remarque : ` QPermission ` est l’API recommandée pour demander des autorisations. Si ` QPermission ` ne prend pas en charge une autorisation Android que vous souhaitez demander, vous pouvez toujours utiliser cette API préliminaire à la place.
Cette fonction a été introduite dans Qt 6.2.
Voir également checkPermission().
[since 6.2] void QtAndroidPrivate::startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Lance l'activité spécifiée par ` intent ` et renvoie le résultat de manière asynchrone via ` resultReceiver ` si celle-ci n'est pas nulle.
Si resultReceiver est null, la méthode startActivity() de QNativeInterface::QAndroidApplication::context() sera appelée. Sinon, startActivityForResult() sera appelée.
receiverRequestCode est un code de requête unique à resultReceiver et sera renvoyé avec le résultat, ce qui permet d'utiliser le même récepteur pour plusieurs intentions.
Cette fonction a été introduite dans Qt 6.2.
[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Lance l'activité spécifiée par intent et renvoie le résultat de manière asynchrone via resultReceiver si celle-ci n'est pas nulle.
Si resultReceiver est null, la méthode startActivity() de QNativeInterface::QAndroidApplication::context() sera appelée. Sinon, startActivityForResult() sera appelée.
receiverRequestCode est un code de requête unique à l’ resultReceiver, qui sera renvoyé avec le résultat, ce qui permet d’utiliser le même récepteur pour plusieurs intents.
Cette fonction a été introduite dans Qt 6.2.
[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc)
Lance l'activité indiquée par intent, en utilisant le code de requête receiverRequestCode, et renvoie le résultat en appelant callbackFunc.
Cette fonction a été introduite dans Qt 6.2.
[since 6.2] void QtAndroidPrivate::startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
Lance l'activité indiquée par ` intentSender ` et renvoie le résultat de manière asynchrone via ` resultReceiver ` si celui-ci n'est pas nul.
Si resultReceiver est nul, la méthode startIntentSender() de QNativeInterface::QAndroidApplication::context() sera appelée. Sinon, startIntentSenderForResult() sera appelée.
receiverRequestCode est un code de requête propre à resultReceiver et sera renvoyé avec le résultat, ce qui permet d’utiliser le même récepteur pour plusieurs intents.
Cette fonction a été introduite dans Qt 6.2.
© 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.