Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

better document the possible arguments accepted by wxLaunchDefaultBrowser; in particular mention the 'mailto:' scheme

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@59239 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2009-03-01 14:31:41 +00:00
parent 02b94f4e73
commit 4290e8ed3b
2 changed files with 14 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
interface/wx/utils.h
View File

@@ -366,9 +366,15 @@ bool wxLaunchDefaultApplication(const wxString& document, int flags = 0);
a busy cursor is shown while the browser is being launched (using
wxBusyCursor).
The @a url may also be a local file path (with or without the "file://"
prefix), if it doesn't correspond to an existing file and the URL has no
scheme "http://" is prepended to it by default.
The parameter @a url is interpreted as follows:
- if it has a valid scheme (e.g. @c "file:", @c "http:" or @c "mailto:")
it is passed to the appropriate browser configured in the user system.
- if it has no valid scheme (e.g. it's a local file path without the @c "file:"
prefix), then ::wxFileExists and ::wxDirExists are used to test if it's a
local file/directory; if it is, then the browser is called with the
@a url parameter eventually prefixed by @c "file:".
- if it has no valid scheme and it's not a local file/directory, then @c "http:"
is prepended and the browser is called.
Returns @true if the application was successfully launched.

4
src/common/utilscmn.cpp
View File

@@ -1010,10 +1010,14 @@ static bool DoLaunchDefaultBrowserHelper(const wxString& urlOrig, int flags)
//
// for (int i=0; i<2; i++)
// {
// // test arguments without a valid URL scheme:
// wxLaunchDefaultBrowser("C:\\test.txt", i==0 ? 0 : wxBROWSER_NEW_WINDOW);
// wxLaunchDefaultBrowser("wxwidgets.org", i==0 ? 0 : wxBROWSER_NEW_WINDOW);
//
// // test arguments with different valid schemes:
// wxLaunchDefaultBrowser("file:/C%3A/test.txt", i==0 ? 0 : wxBROWSER_NEW_WINDOW);
// wxLaunchDefaultBrowser("http://wxwidgets.org", i==0 ? 0 : wxBROWSER_NEW_WINDOW);
// wxLaunchDefaultBrowser("mailto:user@host.org", i==0 ? 0 : wxBROWSER_NEW_WINDOW);
// }
// (assuming you have a C:\test.txt file)