名前付き定数
決まった選択肢を持つ組み込み関数のパラメーターは、次のいずれかの名前空間の 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* キーは、US キーボードで入力される記号にちなんで名付けられています。物理的なキーはキーボード レイアウトによって異なります。
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 を受け取ります。任意の数の修飾キーのプレフィックスの後に、キーをちょうど
1 つ指定します。1 回の呼び出しで 1 つの組み合わせのみで、繰り返し回数は指定できません。キーの後には何も続けられません:
"^cx" や "Control+V" は、最初のキーを押すのではなくエラーになります。
| プレフィックス | ^ | + | % | @ |
|---|---|---|---|---|
| 修飾キー | Ctrl | Shift | Alt | Win |
キーは 1 文字の英字または数字 (大文字・小文字どちらも可)、または次の中かっこで囲んだ名前 (大文字・小文字は問いません) のいずれかです: {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})、1 つのテキストでの複数のキー ("^s{ENTER}")、かっこによるグループ ("+(ec)")、Enter を表す
~、{+} のような波かっこで囲んだリテラル文字、短い名前 {BKSP} と {INS} は使えません。