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 ou o gesto foi desenhado com a tecla de desenho). 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}, {DELETE}, {BACKSPACE}, {BKSP} e {INS} 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. Para várias teclas em um mesmo texto, use KeyboardSendKeys, abaixo.
Sequências de teclas (KeyboardSendKeys)
KeyboardSendKeys recebe uma sequência inteira no formato SendKeys da Microsoft, com @ para a tecla
Windows como acima, então toda combinação de teclas também é uma sequência.
| Escreva | Envia |
|---|---|
abc | os caracteres, digitados como estão em qualquer layout de teclado |
^ + % @ antes de uma tecla | Ctrl, Shift, Alt ou Windows mantida pressionada para essa tecla: "^a" é Ctrl+A |
~ | Enter |
{TAB}, {F5}, … | uma tecla pelo nome, os nomes acima |
{LEFT 5}, {a 3} | a tecla ou o caractere esse número de vezes, de 1 a 1000 |
+(abc) | Shift mantida pressionada para cada tecla entre os parênteses |
{+} {^} {%} {~} {@} {(} {)} {{} {}} | o próprio caractere |
Exemplos: "{TAB 3}^a" Tab três vezes e depois Ctrl+A · "^s{ENTER}" Ctrl+S e depois Enter ·
"%(fx)" Alt+F e depois Alt+X · "me{@}example.com~" o endereço e depois Enter.
O texto inteiro é verificado antes que qualquer tecla seja pressionada. Um erro em qualquer parte dele, como
um nome desconhecido entre chaves ou uma { sem }, interrompe a ação com um erro que indica o caractere, e
nada é enviado. Uma sequência tem no máximo 4096 caracteres e 10000 pressionamentos de tecla, contando as
repetições. Cada pressionamento aguarda o tempo da configuração Atraso de digitação, como
KeyboardTypeText faz, exceto que uma tecla de seta, Home, End, Page Up ou Page Down repetida é enviada de
uma vez.
Com Ctrl, Alt, Shift ou Windows pressionada, uma letra, um dígito ou um espaço é a mesma tecla em qualquer
layout de teclado. Qualquer outro caractere é procurado no layout da janela que está na frente: "^;" é uma
tecla diferente em um layout alemão e em um americano, e um caractere que esse layout não consegue digitar
com um modificador é um erro.
Uma letra depois de um modificador é a tecla dela, maiúscula ou não: "^A" é Ctrl+A, o mesmo que "^a".
Para pressionar Ctrl+Shift+A, escreva "^+a". O SendKeys da Microsoft acrescenta Shift para uma maiúscula,
então uma importação do StrokesPlus.net escreve o Shift por você.
Envie texto simples com KeyboardTypeText, não com KeyboardSendKeys. Aqui + ^ % ~ @ ( ) { } são
comandos, não caracteres: "50% off" pressiona Alt+Space, e em "[email protected]" o @ mantém a tecla
Windows pressionada para o e. Um texto que você não escreveu, como a área de transferência ou uma variável,
pode conter qualquer um deles, então nunca o passe para KeyboardSendKeys.