En esta página

QPermission Class

Un envoltorio opaco de un permiso tipado. Más...

Encabezado: #include <QPermissions>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.5

Funciones públicas

QPermission()
QPermission(const T &type)
Qt::PermissionStatus status() const
QMetaType type() const
std::optional<T> value() const

Descripción detallada

La clase QPermission es un envoltorio opaco de un objeto ` typed permission`, que se utiliza al comprobar o solicitar permisos. No es necesario crear este tipo de forma explícita, ya que se utiliza automáticamente al comprobar o solicitar permisos:

qApp->checkPermission(QCameraPermission{});

Al solicitar permisos, se pasará al functor dado una instancia de QPermission, que puede utilizarse para comprobar el resultado de la solicitud:

qApp->requestPermission(QCameraPermission{}, [](const QPermission &permission) {
    if (permission.status() == Qt::PermissionStatus::Granted)
        takePhoto();
});

Para examinar las propiedades del permiso original tipado, utiliza la función ` value()`:

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();
}

Permisos de tipo

Están disponibles los siguientes permisos:

QBluetoothPermission

Acceder a periféricos Bluetooth

QCalendarPermission

Acceder al calendario del usuario

QCameraPermission

Acceder a la cámara para hacer fotos o grabar vídeos

QContactsPermission

Acceder a los contactos del usuario

QLocationPermission

Acceder a la ubicación del usuario

QMicrophonePermission

Acceder al micrófono para escuchar o grabar sonido

Véase también «Permisos de las aplicaciones».

Documentación de funciones de miembro

[explicit noexcept default] QPermission::QPermission()

Crea por defecto una instancia de ` QPermission`.

template <typename T> requires if_permission<T> QPermission::QPermission(const T &type)

Crea un permiso a partir del typed permission type proporcionado.

No es necesario crear este tipo de forma explícita, ya que se utiliza automáticamente al comprobar o solicitar permisos.

Restricciones

Participa en la resolución de sobrecargas solo si ` T ` es una de las clases de ` typed permission `:

QBluetoothPermission

Acceder a periféricos Bluetooth

QCalendarPermission

Acceder al calendario del usuario

QCameraPermission

Acceder a la cámara para hacer fotos o grabar vídeos

QContactsPermission

Acceder a los contactos del usuario

QLocationPermission

Acceder a la ubicación del usuario

QMicrophonePermission

Acceder al micrófono para escuchar o grabar sonido

Qt::PermissionStatus QPermission::status() const

Devuelve el estado del permiso.

QMetaType QPermission::type() const

Devuelve el tipo del permiso.

template <typename T> requires if_permission<T> std::optional<T> QPermission::value() const

Devuelve el objeto « typed permission » de tipo « T », o « std::nullopt » si este objeto « QPermission » no contiene ninguno.

Utiliza ` type()` para seleccionar dinámicamente qué permiso tipado solicitar.

Restricciones

Participa en la resolución de sobrecarga solo si T es una de las clases de typed permission:

QBluetoothPermission

Acceder a periféricos Bluetooth

QCalendarPermission

Acceder al calendario del usuario

QCameraPermission

Acceder a la cámara para hacer fotos o grabar vídeos

QContactsPermission

Acceder a los contactos del usuario

QLocationPermission

Acceder a la ubicación del usuario

QMicrophonePermission

Acceder al micrófono para escuchar o grabar sonido

© 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.