ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Executable functions
  • Special cases
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Opens a popup allowing you to select the application that will be used to share a resource (text or document). The application will be opened with the specified resource.
For example, an image can be shared with the application for sending emails. In this case, a new email will be created with the specified image in attachment.
Example
// Share a text displayed in an edit control
IF StartShare(shareText, EDT_Edit) = False THEN
Error(ErrorInfo())
END
Syntax
<Result> = StartShare([<Type>, ] <Parameter 1> [, <Parameter 2> [... [, <Parameter N>]]])
<Result>: Boolean
  • True if the specified resources can be shared.
    Remarks:
    • This function is not locking: the code that follows the call to this function will continue to run as soon as the popup is displayed.
    • It is not possible to find out whether an application was selected by the user to perform the share.
  • False if no application allowing to share the resources is found. To get more details on the error, use ErrorInfo.
<Type>: Optional Integer constant
Type of resource to share:
shareDocument
(Default value)
One or more documents (image, video, pdf, ...) are shared. These documents are identified by their full path, specified as parameter (<Parameter 1> to <Parameter N>).
The document must be located in the shared memory of the device (for example: the SDCard) in order to be used by the external application selected for the share.
shareTextText is shared.
If several character strings are specified as parameters (<Parameter 1> to <Parameter N>), they are concatenated and separated by carriage returns (CR).
<Parameter 1>: Character string
First resource to share. Corresponds to:
  • a file path (if the shareDocument constant is used).
  • a character string (if the shareText constant is used).
<Parameter 2>: Optional character string
Second resource to share. Corresponds to:
  • a file path (if the shareDocument constant is used).
  • a character string (if the shareText constant is used).
<Parameter N>: Optional character string
Last resource to share. Corresponds to:
  • a file path (if the shareDocument constant is used).
  • a character string (if the shareText constant is used).
Remarks

Special cases

  • To customize the title of popup for selecting the application, use NextTitle before StartShare.
  • If only one application lets you share the resource on the mobile, the popup is not displayed and the application starts directly.
Component: wd290android.aar
Minimum version required
  • Version 18
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help