StartShare (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Executable functions

Special cases
Application in the background: Specific case from Android 10

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

StartShare (Function)

In french: LancePartage

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

// Partage d'une image affichée dans un champ Image
sChemin is string = CompleteDir(SysDirExternalStorage(1, ssePublicPhoto)) + "MonImage.png"
IF dSaveImagePNG(IMG_Image, sChemin) = True THEN
	NextTitle("Partage d'une image")
	StartShare(sChemin) 
END

// Partage d'une image affichée dans un champ Image
sChemin is string = CompleteDir(fDataDir()) + "MonImage.png"
IF dSaveImagePNG(IMG_Image, sChemin) = True THEN
	NextTitle("Partage d'une image")
	StartShare(sChemin) 
END

// Partage d'un texte affiché dans un champ de saisie
IF StartShare(shareText, SAI_Saisie) = 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 blocking: the code following the function call will continue to run as soon as the popup has been 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 on the device's shared memory (e.g. the SDCard) so that it can be manipulated by the third-party application selected for sharing.
Only the images are supported.
shareText Text is shared.
If several character strings are specified as parameters (<Parameter 1> to <Parameter N>), they are concatenated and separated by carriage returns (CR).
Please note: The Facebook application does not support automatic text sharing.

<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.
Note: This function is available in the Android emulator.. This function is not available in the Android simulator.

Application in the background: Specific case from Android 10

Starting with Android 10, it is no longer possible to open a window when the application is in the background.

StartShare 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). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

For more details, see Android 10: Behavior of applications in the background.

Component: wd300android.aar