QDesktopServices Class

Documentación de las funciones miembro

[static] bool QDesktopServices::openUrl(const QUrl &url)

Abre la dirección url en el navegador web adecuado para el entorno de escritorio del usuario y devuelve true si se ha abierto correctamente; en caso contrario, devuelve false.

Si la URL es una referencia a un archivo local (es decir, el esquema de URL es "archivo"), se abrirá con una aplicación adecuada en lugar de con un navegador web.

El siguiente ejemplo abre un archivo en el sistema de archivos de Windows que reside en una ruta que contiene espacios:

QDesktopServices::openUrl(QUrl("file:///C:/Program Files", QUrl::TolerantMode));

Si se especifica una URL mailto, se utilizará el cliente de correo electrónico del usuario para abrir una ventana de composición que contenga las opciones especificadas en la URL, de forma similar a como se gestionan los enlaces mailto en un navegador Web.

Por ejemplo, la siguiente URL contiene un destinatario (user@foo.com), un asunto (Test), y un cuerpo de mensaje (Just a test):

mailto:user@foo.com?subject=Test&body=Just a test

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
</array>

Véase también setUrlHandler().

[static] void QDesktopServices::setUrlHandler(const QString &scheme, QObject *receiver, const char *method)

Establece el manejador para el scheme dado para que sea el manejador method proporcionado por el objeto receiver.

Esta función permite personalizar el comportamiento de openUrl(). Si openUrl() es llamado con una URL con el scheme especificado entonces el method dado en el objeto receiver es llamado en lugar de QDesktopServices lanzando una aplicación externa.

El método proporcionado debe implementarse como una ranura que sólo acepte un único argumento QUrl.

class MyHelpHandler : public QObject
{
    Q_OBJECT
public:
    // ...
public slots:
    void showHelp(const QUrl &url);
};

Si setUrlHandler() se utiliza para establecer un nuevo manejador para un esquema que ya tiene un manejador, el manejador existente es simplemente reemplazado por el nuevo. Dado que QDesktopServices no se apropia de los manejadores, no se elimina ningún objeto cuando se sustituye un manejador.

Tenga en cuenta que el manejador siempre será llamado desde el mismo hilo que llama a QDesktopServices::openUrl().

Debe llamar a unsetUrlHandler() antes de destruir el objeto manejador, para que la destrucción del objeto manejador no se solape con invocaciones concurrentes de openUrl() que lo utilicen.

iOS y macOS

Para utilizar esta función para recibir datos de otras aplicaciones en iOS/macOS también debe añadir el esquema personalizado a la lista CFBundleURLSchemes de su archivo Info.plist:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

Para obtener más información, consulte la Documentación para desarrolladores de Apple para definir un esquema de URL personalizado para su aplicación.

Para reclamar soporte para http y https no se permite la entrada anterior en el archivo Info.plist. Esto sólo es posible cuando añade su dominio al archivo de derechos:

<key>com.apple.developer.associated-domains</key>
<array>
    <string>applinks:your.domain.com</string>
</array>

iOS/macOS buscará /.well-known/apple-app-site-association en tu dominio, cuando se instale la aplicación. Si desea escuchar a https://your.domain.com/help?topic=ABCDEF es necesario proporcionar el siguiente contenido allí:

{
    "applinks": {
        "apps": [],
        "details": [{
            "appIDs" : [ "ABCDE12345.com.example.app" ],
            "components": [{
                "/": "/help",
                "?": { "topic": "?*"}
            }]
        }]
    }
}

Para obtener más información, consulte la documentación para desarrolladores de Apple sobre la compatibilidad con dominios asociados.

Android

Para utilizar esta función para recibir datos de otras aplicaciones en Android, debe añadir uno o más filtros de intención a activity en el manifiesto de su aplicación:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="your.domain.com" android:port="1337" android:path="/help"/>
</intent-filter>

Para obtener más información, consulte la documentación para desarrolladores de Android para Crear enlaces profundos al contenido de la aplicación.

Para abrir inmediatamente el contenido correspondiente en tu aplicación Android, sin que el usuario tenga que seleccionar la aplicación, necesitas verificar tu enlace. Para habilitar la verificación, añada un parámetro adicional a su filtro de intención:

<intent-filter android:autoVerify="true">

Android buscará https://your.domain.com/.well-known/assetlinks.json, cuando se instale la aplicación. Si desea escuchar https://your.domain.com:1337/help, deberá proporcionar allí el siguiente contenido:

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.app",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

Para obtener más información, consulte la documentación para desarrolladores de Android para Verificar enlaces de aplicaciones Android.

Consulte también openUrl() y unsetUrlHandler().

[static] void QDesktopServices::unsetUrlHandler(const QString &scheme)

Elimina un manejador de URL previamente establecido para el scheme especificado.

Llama a esta función antes de que se destruya el objeto manejador que se registró para scheme, para evitar que las llamadas concurrentes a openUrl() continúen llamando al objeto manejador destruido.

Véase también setUrlHandler().