Run / RunWait
実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 |
キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル |
レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト
Run / RunWait[編集]
外部プログラムを起動する。
RunWaitでは、起動したプログラムの終了を待ち、ErrorLevelに終了コードを格納する。
Run, Target [, WorkingDir, Max|Min|Hide/UseErrorLevel, OutputVarPID]
Parameters[編集]
| 引数名 | 説明 | |
|---|---|---|
| Target | ファイル名やコマンドライン文字列、あるはURLを指定する。 ファイル名の前に openなどとシェルの動作を指定できる。詳しくはRemarks参照。パスが省略された場合は、最初に%A_WorkingDir%のディレクトリが検索され、見つからなければパスの通ったディレクトリが検索される。 , を含むときは、 `, のようにエスケープする必要があるので注意。
| |
| WorkingDir | 起動するプログラムの作業ディレクトリを指定。省略時は%A_WorkingDir% | |
| Max|Min|Hide/UseErrorLevel | Max/Min/Hideはウィンドウの状態。 省略時は、通常のウィンドウ。 対応していないアプリケーションもある。 | |
| Max | 最大化で起動。 | |
| Min | 最小化で起動。 | |
| Hide | 非表示で起動。 | |
| UseErrorLevel | プログラムファイルが見つからないなどのエラーが発生したとき、ダイアログを表示せず、ErrorLevelに ERRORを格納するようにする。このオプションは、ほかのオプションと同時に指定できる。(半角スペースで区切って指定) このオプションを利用した場合 A_LastError にはGetLastError() 関数の結果が格納される。 | |
| OutputVarPID | 起動したプログラムのプロセスIDを格納する変数名。 このIDを使って、Processコマンドで、プロセスを終了したり、終了しているかどうかを確認したりできる。 取得に失敗したときは空になる。 Targetに実行ファイル名以外のものを指定した場合は取得に失敗する。 | |
ErrorLevel[編集]
Run: Does not set ErrorLevel unless UseErrorLevel (above) is in effect, in which case ErrorLevel is set to the word ERROR upon failure or 0 upon success.
RunWait: Sets ErrorLevel to the program's exit code (a signed 32-bit integer). If UseErrorLevel is in effect and the launch failed, the word ERROR is stored.
AHKL [v1.1.04+] このコマンドは失敗した場合に例外をスローすることができる。詳細は実行時エラーを参照。
Remarks[編集]
指定したファイルが見つからず起動に失敗すると、エラーダイアログが表示され、現在のスレッドを終了する。
RunWaitで終了を待っている間は、他のスレッドが割り込むことが可能。
EnvSetコマンドで環境変数に代入していると、起動されたプログラム内でその環境変数が有効になる。
ファイル名の前に指定する動作としては、以下ものが使用可能。
動作を指定せず、ファイル名だけを指定した場合、デフォルトの動作になる。
| *verb | AHKL [L57+] ファイルに関する動作(システム規定でもカスタムなものでも可)を指定する。 例)「 Run, *Compile %A_ScriptFullPath%」Vista以降では、 *RunAs と指定することで管理者権限で実行の右クリックメニューと同様な動作にできる。
|
| properties | ファイルのプロパティを表示。 |
| find | フォルダの検索ウィンドウを表示。 |
| explore | エクスプローラで開く。 |
| edit | 編集する。 |
| open | 開く。 |
| 印刷する。 |
Related[編集]
Example(s)[編集]
Run, Notepad.exe, C:\My Documents, max
RunWait, %comspec% /c dir c:\ >>c:\DirTest.txt, , min
Run, c:\DirTest.txt
Run, properties c:\DirTest.txt
Run, www.autohotkey.com ; i.e. any URL can be launched.
Run, mailto:[email protected]
