PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Use in service mode
  • Operating mode in GO mode and at runtime
  • Required application feature
  • Running an APK file setup
  • Application in the background: Android 10 specific case
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Opens a document in its associated application. The application is opened first, then the specified document.
Remarks:
  • The application used to open the document is the one associated with the extension of the document in Windows (INI file or registry). This associated application may differ according to the configurations used.
  • Android The application used to open the document is the application corresponding to the MIME type associated with the file extension. If several applications correspond to the same type of file, a dialog box will be displayed to select the application to start.
  • iPhone/iPad ShellExecute is a locking function: the application will continue to run when closing the document and its associated application. The document must be on the computer.
  • To display any page in a browser, you can also use BrowserRunApp.
Versions 16 and later
Android This function is now available for Android applications.
New in version 16
Android This function is now available for Android applications.
Android This function is now available for Android applications.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for iPhone/iPad applications.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
Windows Mobile
// Open the "Functions.psw" document in Word
ShellExecute("\WDNEWS\Version\Functions.psw")
Windows Mobile
// Open a site in the default browser
ShellExecute("http://www.windev.com")
Windows Mobile
// Start the default messaging
ShellExecute("mailto:pcsoft@windev.com")
// Start the messaging with parameters
// Parameters recognized by Outlook
ShellExecute("mailto:pcsoft@windev.com" + ...
"?subject=Subject: LST &body=Text: the summary of the LST")
Syntax
<Result> = ShellExecute(<File name> [, <Verb>])
<Result>: Boolean
  • True if the document was opened,
  • False otherwise.
<File name>: Character string (with quotes)
Name and full (or relative) path of document to open. A UNC path can be used.
If space characters are found in the name or path of the document to open, the quotes found around this parameter must be tripled.
Windows Mobile No relative path or UNC path can be used.
Versions 16 and later
AndroidAndroid Widget This parameter can correspond to a full path, to a relative path or to a URI.
For example:
  • "/sdcard/photo.png"
  • "/sdcard/video.3gp".
  • "http://www.windev.com": starts the Web browser on the specified page.
  • "geo:1.44951,43.604363": starts Google Maps or equivalent.
  • "mailto:pcsoft@pcsoft.fr" starts the application for sending emails.
  • "sms:0612345678": starts the application for sending SMSs.
The files found in the application directory (or in one of its sub-directories) are not accessible by most of the external applications. We recommend that you use ShellExecute with files found on the external memory of the device (for example: sdcard) because they are accessible from all the applications.
New in version 16
AndroidAndroid Widget This parameter can correspond to a full path, to a relative path or to a URI.
For example:
  • "/sdcard/photo.png"
  • "/sdcard/video.3gp".
  • "http://www.windev.com": starts the Web browser on the specified page.
  • "geo:1.44951,43.604363": starts Google Maps or equivalent.
  • "mailto:pcsoft@pcsoft.fr" starts the application for sending emails.
  • "sms:0612345678": starts the application for sending SMSs.
The files found in the application directory (or in one of its sub-directories) are not accessible by most of the external applications. We recommend that you use ShellExecute with files found on the external memory of the device (for example: sdcard) because they are accessible from all the applications.
AndroidAndroid Widget This parameter can correspond to a full path, to a relative path or to a URI.
For example:
  • "/sdcard/photo.png"
  • "/sdcard/video.3gp".
  • "http://www.windev.com": starts the Web browser on the specified page.
  • "geo:1.44951,43.604363": starts Google Maps or equivalent.
  • "mailto:pcsoft@pcsoft.fr" starts the application for sending emails.
  • "sms:0612345678": starts the application for sending SMSs.
The files found in the application directory (or in one of its sub-directories) are not accessible by most of the external applications. We recommend that you use ShellExecute with files found on the external memory of the device (for example: sdcard) because they are accessible from all the applications.
Versions 18 and later
Universal Windows 10 App Only the files found in the "appdata" directory can be handled. No Internet URL can be specified.
New in version 18
Universal Windows 10 App Only the files found in the "appdata" directory can be handled. No Internet URL can be specified.
Universal Windows 10 App Only the files found in the "appdata" directory can be handled. No Internet URL can be specified.
<Verb>: Optional character string (with quotes)
Verb that must be used to start the document. The verbs are defined for each application, to indicate the actions that can be performed. The most common verbs are open or print. If this parameter is not specified, the verb used will be the default verb for the type of document.
Versions 16 and later
Android This parameter is not available.
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App This parameter is not available.
New in version 16
Android This parameter is not available.
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App This parameter is not available.
Android This parameter is not available.
AndroidAndroid Widget iPhone/iPadUniversal Windows 10 App This parameter is not available.
Remarks

Use in service mode

ShellExecute used in service mode is used to run the associated application but the interface of this application is not visible.
Windows Mobile

Operating mode in GO mode and at runtime

In GO mode (simulation on the development computer), the application to start must be found on the development computer.
At run time, the application to start must be found on the Pocket PC.
The differences between GO mode (simulator) and real use are presented in Differences between GO mode and real use.
Versions 21 and later
Universal Windows 10 App

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.
Required feature: Family and corporate networks
This feature allows the applications to use incoming and outgoing accesses to the family and corporate networks.
New in version 21
Universal Windows 10 App

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.
Required feature: Family and corporate networks
This feature allows the applications to use incoming and outgoing accesses to the family and corporate networks.
Universal Windows 10 App

Required application feature

The use of this function triggers the declaration of one application feature in the application generation wizard.
Required feature: Family and corporate networks
This feature allows the applications to use incoming and outgoing accesses to the family and corporate networks.
Versions 24 and later
Android

Running an APK file setup

From Android 8, to run the setup of an APK file with ShellExecute, it is necessary to modify the permissions required by the application.
Required permission: REQUEST_INSTALL_PACKAGES.
This permission is used to install packages.
For more details (especially for previous versions of WINDEV Mobile), see FAQ 16927: What to do on Android 8 if the setup of an APK file with ShellExecute is no longer allowed?.
New in version 24
Android

Running an APK file setup

From Android 8, to run the setup of an APK file with ShellExecute, it is necessary to modify the permissions required by the application.
Required permission: REQUEST_INSTALL_PACKAGES.
This permission is used to install packages.
For more details (especially for previous versions of WINDEV Mobile), see FAQ 16927: What to do on Android 8 if the setup of an APK file with ShellExecute is no longer allowed?.
Android

Running an APK file setup

From Android 8, to run the setup of an APK file with ShellExecute, it is necessary to modify the permissions required by the application.
Required permission: REQUEST_INSTALL_PACKAGES.
This permission is used to install packages.
For more details (especially for previous versions of WINDEV Mobile), see FAQ 16927: What to do on Android 8 if the setup of an APK file with ShellExecute is no longer allowed?.
Versions 25 and later
AndroidAndroid Widget

Application in the background: Android 10 specific case

From Android 10, it is no longer possible to open a window when the application is in the background.
ShellExecute can open a window. If this function is used while the application is in the background, a fatal error will occur.
Tips:
  • It is possible to determine if the application is in the background using InBackgroundMode.
  • If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.
See Android 10: Behavior of applications in the background for more details.
New in version 25
AndroidAndroid Widget

Application in the background: Android 10 specific case

From Android 10, it is no longer possible to open a window when the application is in the background.
ShellExecute can open a window. If this function is used while the application is in the background, a fatal error will occur.
Tips:
  • It is possible to determine if the application is in the background using InBackgroundMode.
  • If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.
See Android 10: Behavior of applications in the background for more details.
AndroidAndroid Widget

Application in the background: Android 10 specific case

From Android 10, it is no longer possible to open a window when the application is in the background.
ShellExecute can open a window. If this function is used while the application is in the background, a fatal error will occur.
Tips:
  • It is possible to determine if the application is in the background using InBackgroundMode.
  • If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). When the notification is clicked on, the application will be brought back to the foreground if ..ActivateApplication is set to True. It is also possible to open a window from the procedure passed to ..ActionClick.
See Android 10: Behavior of applications in the background for more details.
Business / UI classification : Neutral code
Component : wd260std.dll
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment