QPermission Class Reference

\inmodule QtCore \inheaderfile QPermissions More...

#include <qpermissions.h>

Collaboration diagram for QPermission:

Public Member Functions
	QPermission ()=default
template<typename T, if_permission< T > = true>
	QPermission (const T &t)
Qt::PermissionStatus	status () const
	Returns the status of the permission.
QMetaType	type () const
	Returns the type of the permission.
template<typename T, if_permission< T > = true>
std::optional< T >	value () const

Friends
class	QCoreApplication
Q_CORE_EXPORT QDebug	operator<< (QDebug debug, const QPermission &permission)

Detailed Description

\inmodule QtCore \inheaderfile QPermissions

Since

6.5

An opaque wrapper of a typed permission.

The QPermission class is an opaque wrapper of a \l{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 \l {QPermission::}{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();
}

\target typed permission

Definition at line 34 of file qpermissions.h.

Constructor & Destructor Documentation

QPermission() [1/2]

QPermission::QPermission ( )

explicitdefault

QPermission() [2/2]

template<typename T, if_permission< T > = true>

QPermission::QPermission ( const T & t )

inline

Definition at line 45 of file qpermissions.h.

Member Function Documentation

status()

Qt::PermissionStatus QPermission::status ( ) const

inline

Returns the status of the permission.

Definition at line 47 of file qpermissions.h.

type()

QMetaType QPermission::type ( ) const

inline

Returns the type of the permission.

Definition at line 49 of file qpermissions.h.

value()

template<typename T, if_permission< T > = true>

std::optional< T > QPermission::value ( ) const

inline

Definition at line 52 of file qpermissions.h.

Friends And Related Symbol Documentation

operator<<

Q_CORE_EXPORT QDebug operator<< ( QDebug debug, const QPermission & permission )

friend

Definition at line 662 of file qpermissions.cpp.

QCoreApplication

friend class QCoreApplication

friend

Definition at line 69 of file qpermissions.h.

---

The documentation for this class was generated from the following files:

• qtbase/src/corelib/kernel/qpermissions.h (cbc239b52b6c2518a8099f1d6a3aa55e27eb2ae1)
• qtbase/src/corelib/kernel/qpermissions.cpp (b7a67b46e66f161def5bf879f19c66d3fcec1d8b)