명명된 상수
정해진 선택지가 있는 기본 제공 함수 매개 변수는 다음 네임스페이스 중 하나의 Integer를 받습니다.
이름은 스크립트를 컴파일할 때 해당 숫자로 바뀌므로 실행 시 비용이 없으며, 편집기는 네임스페이스와
점을 입력하면 이름을 자동 완성하고 각 이름의 값과 의미를 보여 줍니다. 대/소문자를 구분하며, 철자가 틀리면 컴파일 오류입니다. 숫자
자체도 동작하지만(VirtualKey.A는 65이고 0x41입니다), 이름을 쓰면 의미가 드러납니다. 정수를
받는 단계 필드도 같은 이름을 받습니다.
| 네임스페이스 | 멤버 = 값 | 사용하는 곳 |
|---|---|---|
MouseButton | Left=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6 | MouseClick, MouseButtonDown/Up, MouseDoubleClick, MouseIsButtonDown. ContextGetStrokeButton이 반환하는 값이기도 합니다(단추 컨텍스트가 없으면 -1). Primary는 Windows가 왼쪽 클릭으로 처리하는 단추이고 Secondary는 오른쪽 클릭으로 처리하는 단추이며, Windows의 "기본 마우스 단추" 설정을 따르므로 일반 클릭이나 오른쪽 클릭에는 이 둘을 사용하십시오. Left와 Right는 물리적 단추입니다. Windows 마우스 설정에서 기본 단추와 보조 단추를 바꾸면 MouseButton.Left 클릭은 물리적 왼쪽 단추이며, Windows는 이를 오른쪽 클릭으로 처리합니다. ContextGetStrokeButton은 바꾼 후의 단추를 Primary 또는 Secondary로 보고하므로, 오른쪽 단추 제스처는 어느 물리적 단추로 그렸든 Secondary로 보고되며, 이 값을 MouseClick에 전달하면 같은 단추가 눌립니다. 기록된 매크로는 Primary와 Secondary를 사용합니다. |
FileNotify | FileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100 | FolderWatchCreate의 filterMask. 비트 플래그이므로 |로 결합합니다. |
AudioEndpoint | Playback=0 Capture=1 Communications=2 | Multimedia* 볼륨 및 음소거 기본 제공 함수 |
WindowStyle | Normal=0 Minimized=1 Maximized=2 Hidden=3 | ShellRunProgram |
ShellVerb | Open=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6 | ShellRunProgram의 verb. 다른 동사도 Text로 받습니다 |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | UIShowDisplayMessage의 location. Text "x,y" 화면 좌표도 받습니다 |
TextAlign | Left=0 Center=1 Right=2 | UIShowDisplayMessage/UIUpdateDisplayMessage |
LockResult | Acquired=0 TimedOut=1 Pinned=2 | UtilityLockAcquire/UtilityLockAcquirePinned가 반환 |
LockState | Free=0 HeldByMe=1 HeldByOther=2 Pinned=3 | UtilityLockGetState가 반환 |
SerialParity | None=0 Odd=1 Even=2 Mark=3 Space=4 | SerialOpenPort, SerialMonitorCreate |
SerialStopBits | One=0 OnePointFive=1 Two=2 | SerialOpenPort, SerialMonitorCreate |
DateTimeStyle | ShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6 | DateTimeFormat. FileStamp를 제외한 모든 값은 사용자의 Windows 지역 설정을 따르며, 해당 지역의 달력을 사용합니다. FileStamp는 항상 20261001-140509 형식으로, 시간순으로 정렬되며 파일 이름에 안전하게 사용할 수 있습니다. |
DateTimePart | Year=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6 | DateTimeGetPart. 그레고리력, 현지 시간입니다. Weekday는 ISO 방식으로 1은 월요일, 7은 일요일입니다. |
VirtualKey | Win32 가상 키 코드로, .NET의 Keys 열거형을 따라 이름이 지정되었습니다(아래 목록) | Integer key를 받는 모든 Keyboard* 기본 제공 함수 |
VirtualKey 멤버
Oem* 키는 미국 키보드에서 입력되는 기호를 따라 이름이 지정되었습니다. 실제 물리적 키는 자판
배열에 따라 다릅니다.
LButton RButton Cancel MButton XButton1 XButton2 Back Tab Clear Enter ShiftKey ControlKey Menu Pause CapsLock Escape Space PageUp PageDown End Home Left Up Right Down Select Print Execute PrintScreen Insert Delete Help D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z LWin RWin Apps Sleep NumPad0 NumPad1 NumPad2 NumPad3 NumPad4 NumPad5 NumPad6 NumPad7 NumPad8 NumPad9 Multiply Add Separator Subtract Decimal Divide F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 NumLock Scroll LShiftKey RShiftKey LControlKey RControlKey LMenu RMenu BrowserBack BrowserForward BrowserRefresh BrowserStop BrowserSearch BrowserFavorites BrowserHome VolumeMute VolumeDown VolumeUp MediaNextTrack MediaPreviousTrack MediaStop MediaPlayPause LaunchMail SelectMedia LaunchApplication1 LaunchApplication2 OemSemicolon Oemplus Oemcomma OemMinus OemPeriod OemQuestion Oemtilde OemOpenBrackets OemPipe OemCloseBrackets OemQuotes Oem8 Oem102
키 조합 텍스트(KeyboardPressKeyCombo)
KeyboardPressKeyCombo는 상수가 아닌 Text를 받습니다. 한정자 접두사를 원하는 만큼 쓴 다음 키를
정확히 하나 씁니다. 호출 한 번에 조합 하나이며 반복 횟수는 없습니다. 키 뒤에는 아무것도 올 수
없습니다. "^cx"나 "Control+V"는 첫 번째 키를 누르는 것이 아니라 오류입니다.
| 접두사 | ^ | + | % | @ |
|---|---|---|---|---|
| 한정자 키 | Ctrl | Shift | Alt | Win |
키는 문자나 숫자 하나(대/소문자 무관)이거나, 중괄호로 묶은 다음 이름 중 하나입니다(대/소문자 무관): {ENTER}
{ESC} {TAB} {DEL} {BS} {SPACE} {HOME} {END} {PGUP} {PGDN} {LEFT} {RIGHT}
{UP} {DOWN} {INSERT} {F1}…{F24} {PRTSC} {CAPSLOCK} {NUMLOCK} {SCROLLLOCK}
{BREAK} {HELP} {CLEAR} {NUMPAD0}…{NUMPAD9} {MULTIPLY} {ADD} {SEPARATOR}
{SUBTRACT} {DECIMAL} {DIVIDE}. {ESCAPE}와 {DELETE}도 동작합니다.
예: "^c" Ctrl+C · "^+{ESC}" Ctrl+Shift+Esc · "%{F4}" Alt+F4 · "@d" Win+D ·
"^{HOME}" Ctrl+Home · "{enter}" Enter.
.NET의 SendKeys에 익숙하다면: 접두사와 중괄호 안의 이름은 Microsoft의
SendKeys 구문을 따릅니다. 이 텍스트에는
Windows 키를 나타내는 @와 숫자 키패드 고유의 키를 나타내는 {NUMPAD0}…{NUMPAD9}, {SEPARATOR}, {DECIMAL}이
추가되어 있습니다. 반복 횟수({LEFT 4}), 한 텍스트에 여러 키("^s{ENTER}"), 괄호로 묶은 그룹("+(ec)"), Enter를
나타내는 ~, {+} 같은 중괄호 안의 리터럴 문자, 짧은 이름 {BKSP}와 {INS}는 지원하지 않습니다.