ShellExecute (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.

Use in service mode

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ShellExecute (Function)

In french: LanceAppliAssociée

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.
To display any page in a browser, you can also use BrowserRunApp.

Versions 19 and later

This function is now available for Java applications.

New in version 19

This function is now available for Java applications.

Example

// Ouvre le document "Fonctions.doc" dans Word
ShellExecute("C:\WDNEWS\Version\Fonctions.doc")
// Imprime le document
ShellExecute("C:\WDNEWS\Version\Fonctions.doc", "print")

// Ouverture d'un site dans le navigateur par défaut
ShellExecute("http://www.pcsoft.fr")

// Lancement de la messagerie configurée par défaut
ShellExecute("mailto:pcsoft@pcsoft.fr")
// Lancement de la messagerie avec paramètres
// Paramètres reconnus par Outlook
ShellExecute("mailto:pcsoft@pcsoft.fr" + ...
"?subject=Sujet: LST &body=Texte: le sommaire de la LST")

// Ouvre le document "Facture.doc" à partir de son raccourci
ShellExecute("""C:\Documents and Settings\Julie\Bureau\Raccourci vers Facture.doc.lnk""")

Syntax

<Result> = ShellExecute(<File name> [, <Verb>])

<Result>: Boolean

True if the document was opened,
False otherwise.
This parameter is not available. This function returns no result.
Returns False if the application is run with a Java virtual machine (JRE) earlier than version 1.6.

<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.

<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.
This parameter is not available.

Versions 16 and later
This parameter is not available.
This parameter is not available.
New in version 16
This parameter is not available.
This parameter is not available.
This parameter is not available.
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.

Business / UI classification: Neutral code

Component: wd260std.dll