Add note clarifying return value of QDesktopServices::openUrl()

On some platforms (notably wayland and xcb) the openUrl() call returns
as soon as the request is passed to the underlying system. The call may
still fail, but this status is not reported to the application.

Change-Id: Iea554e9d5e7e371a5ce11454aef6f5c66ba36ca0
Reviewed-by: Valerio Valerio <valerio.valerio@jollamobile.com>
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>
bb10
Aaron McCarthy 2015-03-10 15:16:30 +10:00 committed by Aaron McCarthy
parent 5bee3ac1da
commit 45a0629a95
1 changed files with 5 additions and 0 deletions

View File

@ -166,6 +166,11 @@ void QOpenUrlHandlerRegistry::handlerDestroyed(QObject *handler)
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.
\warning A return value of \c true indicates that the application has successfully requested
the operating system to open the URL in an external application. The external application may
still fail to launch or fail to open the requested URL. This result will not be reported back
to the application.
\sa setUrlHandler()
*/
bool QDesktopServices::openUrl(const QUrl &url)