QPermission Class
An opaque wrapper of a typed permission. More...
| Header: | #include <QPermissions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Since: | Qt 6.5 |
Public Functions
| QPermission(const T &type) | |
| Qt::PermissionStatus | status() const |
| QMetaType | type() const |
| std::optional<T> | value() const |
Detailed Description
The QPermission class is an opaque wrapper of a typed permission, used when checking or requesting permissions. You do not need to construct this type explicitly, as the type is automatically used when checking or requesting permissions:
qApp->checkPermission(QCameraPermission{});
When requesting permissions, the given functor will be passed an instance of a QPermission, which can be used to check the result of the request:
qApp->requestPermission(QCameraPermission{}, [](const QPermission &permission) { if (permission.status() == Qt::PermissionStatus:Granted) takePhoto(); });
To inspect the properties of the original, typed permission, use the value() function:
QLocationPermission locationPermission; locationPermission.setAccuracy(QLocationPermission::Precise); qApp->requestPermission(locationPermission, this, &LocationWidget::permissionUpdated);
void LocationWidget::permissionUpdated(const QPermission &permission) { if (permission.status() != Qt::PermissionStatus:Granted) return; auto locationPermission = permission.value<QLocationPermission>(); if (!locationPermission || locationPermission->accuracy() != QLocationPermission::Precise) return; updatePreciseLocation(); }
Typed Permissions
The following permissions are available:
Access Bluetooth peripherals | |
Access the user's calendar | |
Access the camera for taking pictures or videos | |
Access the user's contacts | |
Access the user's location | |
Access the microphone for monitoring or recording sound |
See also Application Permissions.
Member Function Documentation
template <typename T, if_permission<T>> QPermission::QPermission(const T &type)
Constructs a permission from the given typed permission type.
You do not need to construct this type explicitly, as the type is automatically used when checking or requesting permissions.
This constructor participates in overload resolution only if T is one of the typed permission classes:
Access Bluetooth peripherals | |
Access the user's calendar | |
Access the camera for taking pictures or videos | |
Access the user's contacts | |
Access the user's location | |
Access the microphone for monitoring or recording sound |
Qt::PermissionStatus QPermission::status() const
Returns the status of the permission.
QMetaType QPermission::type() const
Returns the type of the permission.
template <typename T, if_permission<T>> std::optional<T> QPermission::value() const
Returns the typed permission of type T, or std::nullopt if this QPermission object doesn't contain one.
Use type() for dynamically choosing which typed permission to request.
This function participates in overload resolution only if T is one of the typed permission classes:
Access Bluetooth peripherals | |
Access the user's calendar | |
Access the camera for taking pictures or videos | |
Access the user's contacts | |
Access the user's location | |
Access the microphone for monitoring or recording sound |
© 2023 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.