Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
%HI_ShellExecute function
Function
The function calls the function ShellExecuteEx Win32 API, which enables to open a file in a default browserviewer.
Declaration
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
%HI_ShellExecute( TEXT in sVerb, TEXT in sFile ) |
Parameters
| sVerb | Required action. |
| sFile | File name. |
Description
The action does not direct to the specific graphic object. Parameter sFile contains the file name over which the action is executed.
According to value of sVerb the action is as follows:
| "" | Executes default action (open). |
| "openas" | Opens dialog to select some program which will open the file. |
| "edit" | Launches an editor and opens the document for editing. If sFile is not a document file, the function will fail. |
| "explore" | Explores the folder specified by sFile. |
| "find" | Initiates a search starting from the specified directory. |
| "open" | Opens the file specified by the sFile parameter. The file can be an executable file, a document file, or a folder. |
| "print" | Prints the document file specified by sFile. If sFile is not a document file, the function will fail. |
| "properties" | Displays the file or folder's properties. |
There can occur another actions. They Other actions can be specified, however, they specifically depend on a file type.
Return value of the function matches with the return value of the function Win32 API GetLastError. If successful, the return value is 0 (zero), otherwise a numeric error code is returned. Example
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
ENTRY GO_OnClick
INT _retCode
; Opens menu to select some browser of pdf documents
_retCode := %HI_ShellExecute("openas", "d:\work\Hoard\asplos2000.pdf")
; Opens a default browser of pdf documents
_retCode := %HI_ShellExecute("open", "d:\work\Hoard\asplos2000.pdf")
END GO_OnClick |