QDesktopServices Class

Dokumentation der 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 false.

Wenn die URL ein Verweis auf eine lokale Datei ist (d.h. das URL-Schema ist "file"), wird sie mit einer geeigneten Anwendung anstelle eines Webbrowsers geöffnet.

Im folgenden Beispiel wird eine Datei im Windows-Dateisystem geöffnet, die sich in einem Pfad befindet, der Leerzeichen enthält:

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

Wenn eine URL mailto angegeben ist, wird der E-Mail-Client des Benutzers verwendet, um ein Composer-Fenster zu öffnen, das die in der URL angegebenen Optionen enthält, ähnlich wie mailto Links von einem Webbrowser behandelt werden.

Zum Beispiel enthält die folgende URL 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)

Setzt den Handler für das angegebene scheme auf den Handler method, der durch das Objekt receiver bereitgestellt wird.

Diese Funktion bietet eine Möglichkeit, das Verhalten von openUrl() anzupassen. Wenn openUrl() mit einer URL mit dem angegebenen scheme aufgerufen wird, wird der angegebene method auf dem receiver Objekt aufgerufen, anstatt QDesktopServices eine externe Anwendung zu starten.

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

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

Wenn setUrlHandler() verwendet wird, um einen neuen Handler für ein Schema zu setzen, das bereits einen Handler hat, wird der bestehende Handler einfach durch den neuen ersetzt. Da QDesktopServices keine Handler in Besitz nimmt, werden keine Objekte gelöscht, wenn ein Handler ersetzt wird.

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

Sie müssen unsetUrlHandler() aufrufen, bevor Sie das Handler-Objekt zerstören, damit sich die Zerstörung des Handler-Objekts nicht mit gleichzeitigen Aufrufen von openUrl() überschneidet, die es verwenden.

iOS und macOS

Um diese Funktion für den Empfang von Daten aus anderen Apps unter iOS/macOS zu verwenden, müssen Sie auch das benutzerdefinierte Schema zur Liste CFBundleURLSchemes in Ihrer Datei Info.plist hinzufügen:

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

Weitere Informationen finden Sie in der Apple Developer Documentation for Defining a Custom URL Scheme for Your App.

Um Unterstützung für http und https zu beanspruchen, ist der obige Eintrag in der Datei Info.plist nicht erlaubt. Dies ist nur möglich, wenn Sie Ihre Domäne zur Entitlements-Datei hinzufügen:

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

iOS/macOS wird nach /.well-known/apple-app-site-association auf Ihrer Domain suchen, wenn die Anwendung installiert wird. Wenn Sie https://your.domain.com/help?topic=ABCDEF abhören möchten, müssen Sie dort den folgenden Inhalt angeben:

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

Weitere Informationen finden Sie in der Apple Developer Documentation for Supporting Associated Domains.

Android

Um diese Funktion für den Empfang von Daten von anderen Apps unter Android zu verwenden, müssen Sie einen oder mehrere Absichtsfilter zu 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 zu Create Deep Links to App Content.

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

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

Android wird nach https://your.domain.com/.well-known/assetlinks.json suchen, wenn die Anwendung installiert ist. Wenn Sie https://your.domain.com:1337/help anhören 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 zu Verify Android App Links.

Siehe auch openUrl() und unsetUrlHandler().

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

Entfernt einen zuvor gesetzten URL-Handler für die angegebene scheme.

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

Siehe auch setUrlHandler().