Run / RunWait

외부 프로그램을 실행합니다. Run과 다르게, RunWait는 실행을 계속하기 전에 프로그램이 끝날 때까지 기다립니다.

Run, Target [, WorkingDir, Max|Min|Hide|UseErrorLevel, OutputVarPID]

Target

기동할 문서, URL, 실행 파일 (.exe, .com, .bat, etc.), 단축 아이콘 (.lnk), 또는 문맥 메뉴 (논평 참조). Target이 지역 파일이고 경로가 지정되어 있지 않으면, A_WorkingDir이 제일 먼저 검색됩니다. 거기에서 부합하는 파일이 없으면, 운영체제는 ("알고 있는") PATH 폴더를 검색해 발견하면 그 파일을 기동합니다.

매개변수를 건네려면, 프로그램이나 문서 이름 다음에 바로 그것들을 추가합니다. 매개변수에 스페이스가 담겨 있다면, (어떤 경우는 겹따옴표 없이도 잘 작동하겠지만) 그것을 겹따옴표 안에 둘러싸는 것이 가장 안전합니다.

WorkingDir

기동된 항목을 위한 작업 디렉토리. 안에 스페이스가 있더라도 이름을 겹따옴표로 둘러싸지 마십시오. 생략하면, 스크립트의 작업 디렉토리가 (A_WorkingDir) 사용됩니다.

Max|Min|Hide
UseErrorLevel

생략되면, Target이 정상 기동합니다. 대안으로, 다음 단어들을 포함할 수 있습니다:

Max: 최대화 기동

Min: 최소화 기등

Hide: 숨은 채로 기동 (위와 조합해 사용할 수 없습니다)

주의: 어떤 어플리케이션은 (예, Calc.exe) 요청한 기동 상태를 준수하지 않습니다. 그런 경우 Max/Min/Hide는 아무 효과가 없습니다.

UseErrorLevel: UseErrorLevel 홀로 지정하거나 위이 단어 중 하나에 추가해 지정할 수 있습니다 (다른 단어와는 스페이스로 구분합니다). 기동에 실패하면, 이 옵션은 경고 대화상자를 건너뛰고, ErrorLevel에 ERROR를 설정하며, 그리고 현재 쓰레드를 계속 진행합니다. 기동에 성공하면, RunWait는 ErrorLevel을 프로그램의 종료 코드에 설정하고, Run은 거기에 0을 설정합니다.

UseErrorLevel이 지정되면, 변수 A_LastError는 운영 체제의 GetLastError() 함수의 결과에 설정됩니다. A_LastError는 0부터 4294967295 사이의 숫자입니다 (십진수가 아니라 언제나 16진수로 포맷됩니다). 영 (0)은 성공을 뜻하지만, 다른 숫자는 기동에 실패했다는 뜻입니다. 각 숫자는 특정한 에러 조건에 상당합니다 (목록은 www.microsoft.com에서 "시스템 에러 코드"를 검색해 보십시오). ErrorLevel처럼, A_LastError는 쓰레드마다 설정됩니다; 즉, 다른 쓰레드가 인터럽트 해도 변경되지 않습니다. 그렇지만, A_LastError는 DllCall이 설정하기도 합니다.

OutputVarPID

새로 기동한 프로그램의 유일한 Process ID (PID)를 저장할 변수의 이름입니다. PID를 결정할 수 없으면 변수는 비어 있습니다, 보통 그런 경우는 실행 파일 보다는 문맥 메뉴, 문서, 또는 단축 아이콘을 기동할 때 일어납니다. RunWait도 이 매개변수를 지원합니다. 그렇지만 그의 OuputVarPID는 반드시 또다른 메쏘드에서 점검해야 합니다 (그렇지 않으면, 다음 RunWait가 실행하는 줄에 도달할 즈음이면 프로세스가 종료되어 버리기 때문에 PID는 무효가 되어 버립니다).

Run 명령어가 PID를 실행한 후, 해당 프로세스가 만든 창은 아직 존재하지 않을 수 있습니다. 적어도 하나의 창은 만들어지기를 기다리려면, WinWait ahk_pid %OutputVarPID%를 사용하십시오.

[v1.1.04+] 이 명령어는 실패시 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.

Run: (위의) UseErrorLevel이 효과가 없는 한, ErrorLevel을 설정하지 않습니다. 실패시 ErrorLevel은 단어 ERROR이 설정되고 성공하면 0이 설정됩니다.

RunWait: ErrorLevel을 프로그램의 종료 코드에 설정합니다 (부호있는 32-비트 정수). UseErrorLevel가 영향을 미치고 기동에 실패하면 단어 ERROR가 저장됩니다.

Run과 다르게, RunWait는 Target이 종료하거나 끝날 때까지 기다립니다. 종료 시에 ErrorLevel이 프로그램의 종료 코드에 설정됩니다 (부호있는 32-비트 정수). 어떤 프로그램은 여전히 실행 중임에도 불구하고 즉시 반환되는 듯 보입니다; 이런 프로그램은 또다른 프로세스를 퍼트립니다.

Target에 쉼표가 담겨 있으면, 다음 예제에 보여주는 바와 같이 세 번 피신시켜야 합니다:

Run rundll32.exe shell32.dll`,Control_RunDLL desk.cpl`,`, 3  ; 제어판 > 디스플레이 > 설정이 열립니다

Comspec을 통하여 프로그램을 실행할 때 (cmd.exe) -- 아마도 프로그램의 입력이나 출력을 방향전환해야 할 필요가 있기 때문에 -- 실행 파일의 이름이나 경로에 스페이스가 포함되어 있으면, 전체 문자열을 바깥쪽에서 따옴표로 둘러 싸야 합니다. 다음 예제에서, 바깥 따옴표는 빨간색으로 보이고 아쪽의 모든 따옴표는 검정색으로 보입니다:

Run %comspec% /c ""C:\My Utility.exe" "param 1" "second param" >"C:\My File.txt""

Target을 기동할 수 없으면, 에러 창이 화면에 나타나고 현재 쓰레드는 종료합니다. 문자열 UseErrorLevel이 세 번째 매개변수에 포함되어 있거나 에러를 Try/Catch 서술문으로 잡는 경우는 예외로 합니다.

Target이 정확한 경로이면, 수행성능이 약간 개선될 수 있습니다. 예, Run, C:\My Documents\Test.txt 말고 Run, C:\Windows\Notepad.exe "C:\My Documents\Test.txt"으로 지정합니다.

특수한 CLSID 폴더는 Run을 통하여 열 수 있습니다. 예를 들어:

Run ::{20d04fe0-3aea-1069-a2d8-08002b30309d}  ; "내 컴퓨터" 폴더가 열립니다.
Run ::{645ff040-5081-101b-9f08-00aa002f954e}  ; 쓰레기통이 열립니다.

문맥 메뉴는 탐색창에서 파일에 우클릭하면 나타나는 조치들에 상응합니다. 파일이 문맥 메뉴 없이 기동하면, 기본 문맥 메뉴가 (보통 "open") 그 특정한 파일 유형에 대하여 사용됩니다. 지정하면, 문맥 메뉴는 목표 파일 이름 다음에 따라와야 합니다. 현재 다음 문맥 메뉴를 지원합니다:

RunWait가 대기 상태에 있는 동안, 새 쓰레드를 핫키, 맞춤 메뉴 항목, 또는 타이머를 통하여 기동할 수 있습니다.

RunAs, Process, Exit, CLSID List, DllCall

Run, Notepad.exe, C:\My Documents, max

Run, mailto:someone@domain.com?subject=이것은 제목 줄입니다&body=이것은 메시지 몸체의 텍스트입니다.
Run, ReadMe.doc, , Max UseErrorLevel  ; 최대화 상태로 기동하고 실패하더라도 대화상자를 보여주지 않습니다.
if ErrorLevel = ERROR
    MsgBox 문서를 기동할 수 없었습니다.

RunWait, %comspec% /c dir c:\ >>c:\DirTest.txt, , min
Run, c:\DirTest.txt
Run, properties c:\DirTest.txt

Run, http://www.google.com ; 즉, 어떤 URL도 기동할 수 있습니다.
Run, mailto:someone@somedomain.com  ; 기본 이메일 프로그램이 열립니다.

Run ::{20d04fe0-3aea-1069-a2d8-08002b30309d}  ; "내 컴퓨터" 폴더가 열립니다.
Run ::{645ff040-5081-101b-9f08-00aa002f954e}  ; 쓰레기통이 열립니다.

; 여러 명령어를 연속적으로 실행하려면, 사이에 "&&"를 사용하십시오:
Run, %comspec% /c dir /b > C:\list.txt && type C:\list.txt && pause

; 다음을 사용하여 명령어를 실행하고 그 출력을 열람할 수 있습니다:
MsgBox % RunWaitOne("dir " A_ScriptDir)

; ...또는 단 번에 여러 명령어를 실행하고 그 출력을 열람합니다:
MsgBox % RunWaitMany("
(
echo 명령어는 여기에 배치합니다,
echo 하나씩 실행될 것이고,
echo 결국 출력을 얻게 될 것입니다.
)")

RunWaitOne(command) {
    ; WshShell 객체: http://msdn.microsoft.com/en-us/library/aew9yb99
    shell := ComObjCreate("WScript.Shell")
    ; cmd.exe를 통하여 명령어 하나를 실행합니다.
    exec := shell.Exec(ComSpec " /C " command)
    ; 그 명령어의 출력을 읽어 돌려줍니다
    return exec.StdOut.ReadAll()
}

RunWaitMany(commands) {
    shell := ComObjCreate("WScript.Shell")
    ; 명령어 반향을 끄고 cmd.exe를 엽니다
    exec := shell.Exec(ComSpec " /Q /K echo off")
    ; 실행할 명령어를 새줄문자로 갈라서 전송합니다.
    exec.StdIn.WriteLine(commands "`nexit")  ; 언제나 결국 종료합니다!
    ; 모든 명령어의 출력을 읽어 돌려줍니다.
    return exec.StdOut.ReadAll()
}

; ExecScript: 주어진 코드를 새 AutoHotkey 프로세스로 실행합니다.
ExecScript(Script, Wait:=true)
{
    shell := ComObjCreate("WScript.Shell")
    exec := shell.Exec("AutoHotkey.exe /ErrorStdOut *")
    exec.StdIn.Write(script)
    exec.StdIn.Close()
    if Wait
        return exec.StdOut.ReadAll()
}

; 예제:
InputBox expr,, 새 스크립트로 평가할 표현식을 입력하십시오.,,,,,,,, Asc("*")
result := ExecScript("FileAppend % (" expr "), *")
MsgBox % "Result: " result