簡述

QDesktopServices類提供的函式用於訪問常見的桌面服務。

許多桌面環境都會提供一系列服務，可以通過應用程式來執行常見任務，如：以使用者應用程式首選項的方式，開啟一個網頁。

此類包含為服務提供簡單介面的函式，返回值表明執行成功或失敗。

openUrl()函式用於開啟位於任意外部應用程式的URL檔案。如果URL對應於本地檔案系統的資源(URL scheme是”file”)，將會用一個合適的應用程式開啟檔案，否則，將使用一個Web瀏覽器來獲取和顯示該檔案。

|

URL Handlers

openUrl()函式的行為可以定製，對於某些型別的URL，允許應用程式覆蓋預設的處理行為。

排程機制只允許每個URL scheme使用一個自定義handler，使用setUrlHandler()函式。每個handler為一個槽，只接受一個QUrl引數。

對於每個scheme，現有handler可以用unsetUrlHandler()函式移除，這將返回給定scheme的預設行為處理方式。

這個系統很容易實現幫助系統。例如：幫助可以提供標籤和文字瀏覽器使用URL：help://myapplication/mytopic，並通過註冊一個handler就可以顯示應用程式內的幫助文字。

class MyHelpHandler : public QObject
{
    Q_OBJECT
public:
    ...
 

public slots:
    void showHelp(const QUrl &url);
};

QDesktopServices::setUrlHandler("help", helpInstance, "showHelp");

在handler中，如果你認為不能開啟請求的URL，可以呼叫QDesktopServices:openUrl()，它將試圖使用合適的使用者桌面環境開啟URL。

注意：Qt5以後，storageLocation()和displayName() 已經由QStandardPaths類的功能取代。

靜態共有成員函式

• bool openUrl(const QUrl & url)

以使用者桌面環境的適當Web瀏覽器開啟指定的的url。如果成功，返回true；否則，返回false。

例如，用預設瀏覽器（例如：Chrome）開啟一個網址：

QDesktopServices::openUrl(QUrl("http://blog.csdn.net/liang19890820"));

如果URL是本地檔案（即：URL scheme是”file”），將會用一個合適的應用程式開啟，而不是Web瀏覽器。

例如，開啟一個Windows下包含空格的資料夾：

QDesktopServices::openUrl(QUrl("file:///D:/Program Files/Youdao"));

如果指定一個mailto地址，將會開啟e-mail客戶端（例如：Outlook），類似於由一個Web瀏覽器mailto到一個地址。

例如，下面的URL包含收件人（[email protected]）、主題（Qt）和正文（I am a Qter）：

QString strUrl = QString("mailto:%1?subject=%2&body=%3").arg("user@qt.com").arg("Qt").arg("I am a Qter");
QDesktopServices::openUrl(QUrl(strUrl));

警告：

1. 儘管許多e-mail客戶端可以傳送附件，並且是能夠處理unicode，使用者可能已經配置了客戶端沒有這些功能。同時，某些e-mail客戶端（例如：Lotus Notes）使用長URLs可能會有問題。

2. 真正的返回值表示應用程式已成功請求作業系統用外部應用程式開啟請求的URL，但外部應用程式可能仍無法啟動或無法開啟請求的URL，這將不會報告給應用程式。

• void setUrlHandler(const QString & scheme, QObject * receiver, const char * method)

為給定的scheme設定handler，receiver是接受者，method為receiver提供的處理函式。

這個函式提供了一種方法來定製openUrl()行為。如果以指定的scheme呼叫openUrl()（帶引數URL），接受者指定的函式將被呼叫來代替QDesktopServices啟動外部應用程式。

接受者提供的函式必須是一個槽，只有接受一個QUrl引數。

如果setUrlHandler()用於為已經擁有handler的scheme設定一個新的handler，現有的handler將被新的替換。由於QDesktopServices並不需要處理handler的所有權，當handler被替換時不刪除物件。

注意：handler將總是被執行QDesktopServices::openUrl()的相同執行緒呼叫。

例如，檢測到scheme為http或file時，不用預設的應用程式開啟，直接彈出一個提示框：

QDesktopServices::setUrlHandler("http", this, "openUrl");
QDesktopServices::setUrlHandler("file", this, "openUrl");

QDesktopServices::openUrl(QUrl("http://blog.csdn.net/liang19890820"));
QDesktopServices::openUrl(QUrl("file:///D:/Program Files/Youdao"));

bool MainWindow::openUrl(const QUrl &url)
{
    QString strScheme = url.scheme();
    if (QString::compare(strScheme, "http", Qt::CaseInsensitive) == 0)
    {
        QMessageBox::information(this, QString::fromLocal8Bit("提示"), QStringLiteral("開啟的是一個網址：%1").arg(url.url()));
        return true;
    }
    else if(QString::compare(strScheme, "file", Qt::CaseInsensitive) == 0)
    {
        QMessageBox::information(this, QString::fromLocal8Bit("提示"), QStringLiteral("開啟的是一個檔案：%1").arg(url.url()));
        return true;
    }

    return false;
}

很多人看了好多遍還不會這個用法，不明覺厲，趕快去試試吧！

• void unsetUrlHandler(const QString & scheme)

刪除指定scheme預先設定的URL handler。

例如，對於上面定製的handler，現在不需要了：

QDesktopServices::unsetUrlHandler("http");