QDesktopServices Class

Dokumentation zu den Mitgliedsfunktionen

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

Öffnet die angegebene URL „ url “ in dem für die Desktop-Umgebung des Benutzers geeigneten Webbrowser und gibt bei Erfolg „ true “ zurück; andernfalls wird „ false “ zurückgegeben.

Wenn die URL auf eine lokale Datei verweist (d. h., das URL-Schema lautet „file“), wird sie statt in einem Webbrowser mit einer geeigneten Anwendung geöffnet.

Das folgende Beispiel öffnet eine Datei im Windows-Dateisystem, deren Pfad Leerzeichen enthält:

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

Wird eine URL vom Typ „ mailto “ angegeben, wird der E-Mail-Client des Benutzers verwendet, um ein Verfassen-Fenster mit den in der URL angegebenen Optionen zu öffnen – ähnlich wie bei der Verarbeitung von „ mailto “-Links durch einen Webbrowser.

Die folgende URL enthält beispielsweise einen Empfänger (user@foo.com), einen Betreff (Test) und einen Nachrichtentext (Just a test):

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

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

Siehe auch „ setUrlHandler()“.

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

Legt den Handler für die angegebene „ scheme “ auf den Handler „ method “ fest, der vom Objekt „ receiver “ bereitgestellt wird.

Diese Funktion bietet die Möglichkeit, das Verhalten von ` openUrl()` anzupassen. Wird ` openUrl()` mit einer URL aufgerufen, die das angegebene ` scheme ` enthält, wird anstelle von ` QDesktopServices ` die angegebene ` method ` des ` receiver `-Objekts aufgerufen, wodurch eine externe Anwendung gestartet wird.

Die bereitgestellte Methode muss als Slot implementiert werden, der nur ein einziges Argument vom Typ „ QUrl “ akzeptiert.

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

Wird `setUrlHandler()` verwendet, um einen neuen Handler für ein Schema festzulegen, für das bereits ein Handler vorhanden ist, wird der bestehende Handler einfach durch den neuen ersetzt. Da ` QDesktopServices ` keine Eigentumsrechte an Handlern übernimmt, werden beim Ersetzen eines Handlers keine Objekte gelöscht.

Beachten Sie, dass der Handler immer aus demselben Thread heraus aufgerufen wird, der ` QDesktopServices::openUrl()` aufruft.

Sie müssen ` unsetUrlHandler()` aufrufen, bevor Sie das Handler-Objekt vernichten, damit sich die Vernichtung des Handler-Objekts nicht mit gleichzeitigen Aufrufen von ` openUrl()` überschneidet, die dieses Objekt verwenden.

iOS und macOS

Um diese Funktion zum Empfangen von Daten aus anderen Apps unter iOS/macOS zu nutzen, müssen Sie außerdem das benutzerdefinierte Schema zur Liste „ CFBundleURLSchemes “ in Ihrer Info.plist-Datei hinzufügen:

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

Weitere Informationen finden Sie in der Apple-Entwicklerdokumentation unter „Definieren eines benutzerdefinierten URL-Schemas für Ihre App“.

Um die Unterstützung für http und https zu beanspruchen, ist der oben genannte Eintrag in der Datei „Info.plist“ nicht zulässig. Dies ist nur möglich, wenn Sie Ihre Domain zur Datei „Entitlements“ hinzufügen:

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

iOS/macOS sucht bei der Installation der Anwendung auf Ihrer Domain nach der Datei „/.well-known/apple-app-site-association“. Wenn Sie die URL „ https://your.domain.com/help?topic=ABCDEF “ bedienen möchten, müssen Sie dort den folgenden Inhalt bereitstellen:

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

Weitere Informationen finden Sie in der Apple-Entwicklerdokumentation zum Thema „Unterstützung zugeordneter Domains“.

Android

Um diese Funktion zum Empfangen von Daten aus anderen Apps unter Android zu nutzen, müssen Sie einen oder mehrere Intent-Filter zum „ activity “ in Ihrem App-Manifest hinzufügen:

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

Weitere Informationen finden Sie in der Android-Entwicklerdokumentation unter „Deep Links zu App-Inhalten erstellen“.

Um den entsprechenden Inhalt sofort in Ihrer Android-App zu öffnen, ohne dass der Nutzer die App auswählen muss, müssen Sie Ihren Link verifizieren. Um die Verifizierung zu aktivieren, fügen Sie Ihrem Intent-Filter einen zusätzlichen Parameter hinzu:

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

Android sucht nach „ https://your.domain.com/.well-known/assetlinks.json “, wenn die Anwendung installiert ist. Wenn Sie auf „ https://your.domain.com:1337/help “ reagieren möchten, müssen Sie dort den folgenden Inhalt bereitstellen:

[{
  "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"]
  }
}]

Weitere Informationen finden Sie in der Android-Entwicklerdokumentation unter „Android-App-Links überprüfen“.

Siehe auch openUrl() und unsetUrlHandler().

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

Entfernt einen zuvor festgelegten URL-Handler für die angegebene URL „ scheme “.

Rufen Sie diese Funktion auf, bevor das für ` scheme ` registrierte Handler-Objekt zerstört wird, um zu verhindern, dass gleichzeitige Aufrufe von ` openUrl()` weiterhin das zerstörte Handler-Objekt aufrufen.

Siehe auch setUrlHandler().