# QDesktopServices Class Reference ## [[QtGui](index.htm) module] 該QDesktopServices類提供了訪問常用的桌面服務的方法。[More...](#details) ### Types * `enum StandardLocation { DesktopLocation, DocumentsLocation, FontsLocation, ApplicationsLocation, ..., CacheLocation }` ### Methods * `__init__ (self)` * `__init__ (self, QDesktopServices)` ### Static Methods * `QString displayName (StandardLocation?type)` * `bool openUrl (QUrl?url)` * `setUrlHandler (QString?scheme, QObject?receiver, str?method)` * `setUrlHandler (QString?scheme, callable?method)` * `QString storageLocation (StandardLocation?type)` * `unsetUrlHandler (QString?scheme)` * * * ## Detailed Description 該QDesktopServices類提供了訪問常用的桌面服務的方法。 許多桌面環境提供了可以被應用程序用于執行常見任務，如打開一個網頁，在某種程度上，既一致，并考慮到了用戶的應用程序首選項的服務。 這個類包含的功能，提供簡單的界面使用這些服務，表明他們是成功還是失敗。 該[openUrl](qdesktopservices.html#openUrl)（ ）函數用于打開位于在外部應用程序中的任意文件的URL 。對于對應的資源在本地的文件系統（其中的URL方案“文件” ）上的URL ，一個合適的應用程序將被用來打開文件，否則， Web瀏覽器將被用來獲取和顯示文件。 用戶的桌面設置控制某些類型的可執行文件是否被打開進行瀏覽，或者如果他們轉而執行。一些桌面環境配置為防止執行來自非本地URL獲得文件的用戶，或者要求用戶的權限才這樣做。 ### URL Handlers 的行為[openUrl](qdesktopservices.html#openUrl)（ ）函數可以定制個人的URL方案，允許應用程序復蓋默認的處理行為對于某些類型的URL 。 調度機制允許將用于每個URL方案只有一個自定義處理程序，這是使用設置[setUrlHandler](qdesktopservices.html#setUrlHandler)（）函數。每個處理程序被實現為只接受一個單一的插槽[QUrl](qurl.html)的說法。 每個計劃的現有處理程序可以與被刪除[unsetUrlHandler](qdesktopservices.html#unsetUrlHandler)（）函數。這將返回給定的方案的默認行為的處理行為。 這個系統可以很容易地實現一個幫助系統，例如。說明可以使用標籤和文本瀏覽器提供**help://myapplication/mytopic**網址，并通過注冊一個處理程序就能夠在應用程序中顯示的說明文字： ``` class MyHelpHandler : public [QObject](qobject.html) { Q_OBJECT public: ... public slots: void showHelp(const [QUrl](qurl.html) &url); }; QDesktopServices.setUrlHandler("help", helpInstance, "showHelp"); ``` 如果處理程序中你決定，你無法打開請求的URL ，你可以直接調用[QDesktopServices.openUrl](qdesktopservices.html#openUrl)（ ）再次使用相同的參數，它會嘗試使用適當的機制，使用戶的桌面環境打開URL 。 * * * ## Type Documentation ``` QDesktopServices.StandardLocation ``` 該枚舉描述可由QDesktopServices.storageLocation和QDesktopServices.displayName要查詢的不同的位置。 | Constant | Value | Description | | --- | --- | --- | | `QDesktopServices.DesktopLocation` | `0` | 返回用戶的桌面目錄。 | | `QDesktopServices.DocumentsLocation` | `1` | 返回用戶的文檔。 | | `QDesktopServices.FontsLocation` | `2` | 返回用戶的字體。 | | `QDesktopServices.ApplicationsLocation` | `3` | 返回用戶的應用程序。 | | `QDesktopServices.MusicLocation` | `4` | 返回用戶的音樂。 | | `QDesktopServices.MoviesLocation` | `5` | 返回用戶的電影。 | | `QDesktopServices.PicturesLocation` | `6` | 返回用戶的圖片。 | | `QDesktopServices.TempLocation` | `7` | 返回系統的臨時目錄。 | | `QDesktopServices.HomeLocation` | `8` | 返回用戶的主目錄。 | | `QDesktopServices.DataLocation` | `9` | 返回在持久應用程序數據可以被存儲的目錄位置。[QCoreApplication.applicationName](qcoreapplication.html#applicationName-prop)和[QCoreApplication.organizationName](qcoreapplication.html#organizationName-prop)應該在所有平臺上。 | | `QDesktopServices.CacheLocation` | `10` | 返回在用戶特定的非必要（緩存）的數據應該寫入的目錄位置。 | 這個枚舉被引入或修改的Qt 4.4 。 **See also** [storageLocation](qdesktopservices.html#storageLocation)（）和[displayName](qdesktopservices.html#displayName)（ ） 。 * * * ## Method Documentation ``` QDesktopServices.__init__ (self) ``` ``` QDesktopServices.__init__ (self, QDesktopServices) ``` ``` QString QDesktopServices.displayName (StandardLocation?type) ``` 返回給定位置的本地化顯示名稱_type_或空[QString](qstring.html)如果沒有相關的位置可以找到。 ``` bool QDesktopServices.openUrl (QUrl?url) ``` 打開給定的_url_在真實的，如果成功了適當的Web瀏覽器為用戶的桌面環境，并返回，否則返回False 。 如果URL是參考到本地文件（例如， URL模式是“文件” ），然后將它開了一個合適的應用程序，而不是一個Web瀏覽器。 下面的示例打開一個文件駐留在包含空格的路徑上的Windows文件系統： ``` [QDesktopServices](qdesktopservices.html).openUrl([QUrl](qurl.html)("file:///C:/Documents and Settings/All Users/Desktop", [QUrl](qurl.html).TolerantMode)); ``` 如果`mailto`被指定的URL ，用戶的電子郵件客戶端將用于打開包含在URL中，類似的方式指定的選項作曲家窗口`mailto`該書是由Web瀏覽器處理。 例如，下面的URL包含收件人（`user@foo.com`） ，一個主體（`Test`）和消息體（`Just a test`） ： ``` mailto:user@foo.com?subject=Test&body=Just a test ``` **Warning:**雖然許多電子郵件客戶端可以發送附件和識別Unicode ，用戶可能沒有這些功能配置他們的客戶。此外，某些電子郵件客戶端（如Lotus Notes）的有問題，長的URL。 **Note:**基于Symbian操作系統，`SwEvent`能力是必需的打開給定_url_如果Web瀏覽器已經在運行。 **See also** [setUrlHandler](qdesktopservices.html#setUrlHandler)（ ） 。 ``` QDesktopServices.setUrlHandler (QString?scheme, QObject?receiver, str?method) ``` 設置處理程序給定的_scheme_成為該處理程序_method_通過提供_receiver_對象。 此功能提供了一種方法來定制行為[openUrl](qdesktopservices.html#openUrl)（ ） 。如果[openUrl](qdesktopservices.html#openUrl)（ ）被調用與指定的URL_scheme_那么給定的_method_在_receiver_對象被調用，而不是[QDesktopServices](qdesktopservices.html)啟動外部應用程序。 所提供的方法必須被實現為一個時隙只接受單一[QUrl](qurl.html)的說法。 如果setUrlHandler （ ）用來設置上已經有一個處理一個方案一個新的處理程序，現有的處理程序簡單地替換成新的。自[QDesktopServices](qdesktopservices.html)不采取處理程序的所有權，當一個處理器被替換任何對象都將被刪除。 請注意，處理程序將總是從調用同一個線程中調用[QDesktopServices.openUrl](qdesktopservices.html#openUrl)（ ） 。 **See also** [openUrl](qdesktopservices.html#openUrl)（）和[unsetUrlHandler](qdesktopservices.html#unsetUrlHandler)（ ） 。 ``` QDesktopServices.setUrlHandler (QString?scheme, callable?method) ``` ``` QString QDesktopServices.storageLocation (StandardLocation?type) ``` 返回默認的系統目錄下的文件_type_屬于，或空字符串，如果該位置不能確定。 **Note:**返回的存儲位置可以是不存在的目錄，也就是說，它可能需要由系統或用戶創建的。 **Note:**基于Symbian操作系統，[ApplicationsLocation](qdesktopservices.html#StandardLocation-enum)總是相同的驅動器上的可執行文件指向的/ sys / bin文件夾中。[FontsLocation](qdesktopservices.html#StandardLocation-enum)總是指向ROM驅動器上的文件夾中。 Symbian操作系統沒有桌面的概念，[DesktopLocation](qdesktopservices.html#StandardLocation-enum)返回相同的路徑[DocumentsLocation](qdesktopservices.html#StandardLocation-enum)。的標準位置休息指向同一個驅動器上的文件夾具有可執行，但如果可執行文件是在ROM中從C盤的文件夾被返回。 此功能被引入Qt的4.4 。 ``` QDesktopServices.unsetUrlHandler (QString?scheme) ``` 移除先前設置的URL處理程序規定_scheme_。 **See also** [setUrlHandler](qdesktopservices.html#setUrlHandler)（ ） 。