Function Reference

ShellExecute

ShellExecuteAPIを使用して外部プログラムを実行します。

ShellExecute ( "filename" [, "parameters" [, "workingdir" [, "verb" [, showflag]]]] )

 

パラメータ

filename 実行するファイルの名前(EXE、.txt、.lnkなど)。
parameters [オプション]プログラム用パラメータ。空文字("")は「無し」となります。
workingdir [オプション]作業ディレクトリ。空文字("")を使うと現在の作業ディレクトリが使用されます。
verb [オプション]使用する"動詞(verb)"。次のものが使用できます。
  open = 指定されたファイルを開きます。実行ファイル、ドキュメントファイル、フォルダを指定できます。
  edit = エディタを立ち上げ編集用にドキュメントファイルを開きます。"filename"で指定したファイルがドキュメントファイルで無かった場合、関数は失敗します。
  print = 指定されたドキュメントファイルを印刷します。"filename"で指定したファイルがドキュメントファイルで無かった場合、関数は失敗します。
  properties = ファイル、フォルダのプロパティを表示します。
  verbが指定されていない場合のデフォルト処理の詳細については注意を参照。
showflag [オプション]プログラム実行時の"表示"フラグ
  @SW_HIDE = ウィンドウ非表示
  @SW_MINIMIZE = ウィンドウ最小化
  @SW_MAXIMIZE = ウィンドウ最大化

 

返し値

成功 1を返します。
失敗 0を返し、@errorを非ゼロに設定します。

 

注意

要求されたプログラムを実行後、スクリプト処理が継続して実行されます。実行したプログラムが終了するまでスクリプトの処理を一時停止する場合は代わりにShellExecuteWait関数を使用してください。

動詞(verb)が指定されていない場合、デフォルトの動詞(verb)が使用されます。デフォルトの動詞(verb)はレジストリ内の動詞(verb)設定です。レジストリ内にデフォルトの動詞(verb)が設定されていない場合動詞(verb)として"open"が使用されます。動詞(verb)の"open"が存在しない場合、レジストリ内のリストの最初の動詞(verb)が使用されます(Windows 2000を除く)。

 

関連

ShellExecuteWait, Run, RunWait, RunAs, RunAsWait

 


; メモ帳を開く。
ShellExecute("Notepad.exe")

; .txtファイルをデフォルトのエディタで開く
ShellExecute("myfile.txt", "", @ScriptDir, "edit")