Constantes nomeadas
Um parâmetro de função interna com um conjunto fixo de opções recebe um Integer de um destes
namespaces. Os nomes são substituídos pelos seus números quando o script é compilado, então não custam
nada durante a execução, e o editor os completa depois que você digita o namespace e um ponto, mostrando o valor e o significado de cada um. Eles
diferenciam maiúsculas de minúsculas, e um nome escrito errado é um erro de compilação. O próprio número
também funciona (VirtualKey.A é 65, que é 0x41), mas o nome diz o que ele significa. Um campo
de Passos que aceita um número inteiro aceita os mesmos nomes.
| Namespace | Membros = valor | Usado por |
|---|---|---|
MouseButton | Left=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6 | MouseClick, MouseButtonDown/Up, MouseDoubleClick, MouseIsButtonDown; também é o que ContextGetStrokeButton retorna (-1 quando não há contexto de botão). Primary é o botão que o Windows trata como clique esquerdo e Secondary o que ele trata como clique direito, seguindo a configuração "Botão principal do mouse" do Windows, então use-os para um clique ou um clique com o botão direito comuns. Left e Right são os botões físicos: com os botões principal e secundário trocados nas configurações de mouse do Windows, um clique com MouseButton.Left é o botão esquerdo físico, que o Windows trata como clique direito. ContextGetStrokeButton informa o botão já considerando a troca, como Primary ou Secondary, então um gesto com o botão direito informa Secondary, seja qual for o botão físico que o desenhou, e passar o valor para MouseClick pressiona esse mesmo botão. As macros gravadas usam Primary e Secondary. |
FileNotify | FileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100 | o filterMask de FolderWatchCreate. São sinalizadores de bits, então combine-os com |. |
AudioEndpoint | Playback=0 Capture=1 Communications=2 | funções internas Multimedia* de volume e mudo |
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 | o verb de ShellRunProgram, que também aceita qualquer outro verbo como Text |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | o location de UIShowDisplayMessage, que também aceita um ponto da tela como Text "x,y" |
TextAlign | Left=0 Center=1 Right=2 | UIShowDisplayMessage/UIUpdateDisplayMessage |
LockResult | Acquired=0 TimedOut=1 Pinned=2 | retornado por UtilityLockAcquire/UtilityLockAcquirePinned |
LockState | Free=0 HeldByMe=1 HeldByOther=2 Pinned=3 | retornado por 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. Todos, exceto FileStamp, seguem as configurações de região do Windows do usuário, no calendário próprio dessa região; FileStamp é sempre 20261001-140509, que ordena por data e hora e é seguro em um nome de arquivo. |
DateTimePart | Year=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6 | DateTimeGetPart. Calendário gregoriano, hora local. Weekday segue a ISO: 1 é segunda-feira, 7 é domingo. |
VirtualKey | os códigos de tecla virtual do Win32, nomeados conforme a enumeração Keys do .NET (listados abaixo) | toda função interna Keyboard* que recebe um Integer key |
Membros de VirtualKey
As teclas Oem* são nomeadas pelo símbolo que produzem em um teclado americano. A tecla física varia
conforme o layout.
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
Texto de combinação de teclas (KeyboardPressKeyCombo)
KeyboardPressKeyCombo recebe Text, não uma constante: qualquer número de prefixos de modificadores,
depois exatamente uma tecla. Uma combinação por chamada, sem contagem de repetições. Nada pode vir
depois da tecla: "^cx" ou "Control+V" é um erro, não um pressionamento da primeira tecla.
| Prefixo | ^ | + | % | @ |
|---|---|---|---|---|
| Modificador | Ctrl | Shift | Alt | Win |
A tecla é uma única letra ou dígito (maiúscula ou minúscula) ou um destes nomes entre chaves, em maiúsculas ou minúsculas: {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} e {DELETE} também funcionam.
Exemplos: "^c" Ctrl+C · "^+{ESC}" Ctrl+Shift+Esc · "%{F4}" Alt+F4 · "@d" Win+D ·
"^{HOME}" Ctrl+Home · "{enter}" Enter.
Conhece o SendKeys do .NET? Os prefixos e os nomes entre chaves seguem a
sintaxe do SendKeys da Microsoft. Este
texto acrescenta @ para a tecla Windows e {NUMPAD0}…{NUMPAD9}, {SEPARATOR} e {DECIMAL} para as teclas
próprias do teclado numérico. Ele deixa de fora contagens de repetição ({LEFT 4}), várias teclas em um mesmo
texto ("^s{ENTER}"), grupos entre parênteses ("+(ec)"), ~ para Enter, caracteres literais entre chaves
como {+} e os nomes curtos {BKSP} e {INS}.