QDesktopServices Class Reference
|
Constant | Value | Description |
---|---|---|
QDesktopServices::DesktopLocation | 0 | Returns the user's desktop directory. |
QDesktopServices::DocumentsLocation | 1 | Returns the user's document. |
QDesktopServices::FontsLocation | 2 | Returns the user's fonts. |
QDesktopServices::ApplicationsLocation | 3 | Returns the user's applications. |
QDesktopServices::MusicLocation | 4 | Returns the users music. |
QDesktopServices::MoviesLocation | 5 | Returns the user's movies. |
QDesktopServices::PicturesLocation | 6 | Returns the user's pictures. |
QDesktopServices::TempLocation | 7 | Returns the system's temporary directory. |
QDesktopServices::HomeLocation | 8 | Returns the user's home directory. |
QDesktopServices::DataLocation | 9 | Returns a directory location where persistent application data can be stored. QCoreApplication::applicationName and QCoreApplication::organizationName should work on all platforms. |
QDesktopServices::CacheLocation | 10 | Returns a directory location where user-specific non-essential (cached) data should be written. |
This enum was introduced in Qt 4.4.
See also storageLocation() and displayName().
Returns a localized display name for the given location type or an empty QString if no relevant location can be found.
Opens the given url in the appropriate Web browser for the user's desktop environment, and returns true if successful; otherwise returns false.
If the URL is a reference to a local file (i.e., the URL scheme is "file") then it will be opened with a suitable application instead of a Web browser.
The following example opens a file on the Windows file system residing on a path that contains spaces:
QDesktopServices::openUrl(QUrl("file:///C:/Documents and Settings/All Users/Desktop", QUrl::TolerantMode));
If a mailto URL is specified, the user's e-mail client will be used to open a composer window containing the options specified in the URL, similar to the way mailto links are handled by a Web browser.
For example, the following URL contains a recipient (user@foo.com), a subject (Test), and a message body (Just a test):
mailto:user@foo.com?subject=Test&body=Just a test
Warning: Although many e-mail clients can send attachments and are Unicode-aware, the user may have configured their client without these features. Also, certain e-mail clients (e.g., Lotus Notes) have problems with long URLs.
See also setUrlHandler().
Sets the handler for the given scheme to be the handler method provided by the receiver object.
This function provides a way to customize the behavior of openUrl(). If openUrl() is called with a URL with the specified scheme then the given method on the receiver object is called instead of QDesktopServices launching an external application.
The provided method must be implemented as a slot that only accepts a single QUrl argument.
If setUrlHandler() is used to set a new handler for a scheme which already has a handler, the existing handler is simply replaced with the new one. Since QDesktopServices does not take ownership of handlers, no objects are deleted when a handler is replaced.
Note that the handler will always be called from within the same thread that calls QDesktopServices::openUrl().
See also openUrl() and unsetUrlHandler().
Returns the default system directory where files of type belong, or an empty string if the location cannot be determined.
Note: The storage location returned can be a directory that does not exist; i.e., it may need to be created by the system or the user.
Note: On Mac OS X, DataLocation does not include QCoreApplication::organizationName. Use code like this to add it:
QString location = QDesktopServices::storageLocation(QDesktopServices::DataLocation); #ifdef Q_WS_MAC location.insert(location.count() - QCoreApplication::applicationName().count(), QCoreApplication::organizationName() + "/"); #endif
This function was introduced in Qt 4.4.
Removes a previously set URL handler for the specified scheme.
See also setUrlHandler().
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) | Trademarks | Qt 4.5.2 |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |