Funkcia %HI_ShellExecute

Funkcia

Funkcia volá funkciu ShellExecuteEx Win32 API, ktorá umožňuje otvoriť daný súbor v prednastavenom prehliadači.

Deklarácia

%HI_ShellExecute(
   TEXT in sVerb,
   TEXT in sFile
 )

Parametre

sVerb	Požadovaná akcia.
sFile	Meno súboru.

Popis

Akcia nesmeruje na konkrétny grafický objekt. Parameter sFile obsahuje meno súboru, nad ktorým sa akcia vykonáva.

Podľa hodnoty parametra sVerb je akcia nasledovná:

""	Vykoná default akciu (open).
"openas"	Otvorí dialóg na výber programu, ktorým sa má súbor otvoriť.
"edit"	Spúšťa editor a otvorí dokument pre úpravy. Ak sFile nie je dokument, funkcia zlyhá.
"explore"	Skúma priečinok špecifikovaný sFile.
"find"	Spustí prehľadávanie od zadaného adresára.
"open"	Otvorí súbor špecifikovaný parametrom sFile. Tento súbor môže byť spustiteľný súbor, dokument alebo priečinok.
"print"	Vytlačí súbor špecifikovaný sFile. Ak sFile nie je dokumentom, funkcia zlyhá.
"properties"	Zobrazí vlastnosti súboru alebo priečinka.

Môžu byť aj ďalšie, sú špecificky závislé od typu súboru.

Návratová hodnota funkcie zodpovedá návratovej hodnote funkcie Win32 API GetLastError. V prípade úspechu je návratová hodnota 0, ináč číselný kód chyby.

Príklad

  ENTRY GO_OnClick
  INT _retCode

 ; Otvorenie ponuky pre výber prehliadača pdf dokumentu
 _retCode := %HI_ShellExecute("openas", "d:\work\Hoard\asplos2000.pdf")

 ; Otvorenie prednastaveného pdf prehliadača
 _retCode := %HI_ShellExecute("open", "d:\work\Hoard\asplos2000.pdf")
 END GO_OnClick

Súvisiace stránky:

Implementované funkcie
Argumenty funkcie - typy