Constantes nommées
Un paramètre de fonction intégrée qui offre un ensemble fixe de choix prend un Integer issu de l'un
de ces espaces de noms. Les noms sont remplacés par leur nombre à la compilation du script : ils ne
coûtent donc rien à l'exécution, et l'éditeur les complète une fois que vous avez tapé l'espace de
noms et un point, en affichant la valeur et la signification de chacun. Ils sont sensibles à la casse, et un nom mal orthographié est une erreur de
compilation. Le nombre lui-même fonctionne aussi (VirtualKey.A vaut 65, soit 0x41), mais le
nom dit ce qu'il signifie. Un champ d'Étapes qui accepte un nombre entier accepte les mêmes noms.
| Espace de noms | Membres = valeur | Utilisé par |
|---|---|---|
MouseButton | Left=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6 | MouseClick, MouseButtonDown/Up, MouseDoubleClick, MouseIsButtonDown ; c'est aussi ce que renvoie ContextGetStrokeButton (-1 en l'absence de contexte de bouton). Primary est le bouton que Windows traite comme un clic gauche et Secondary celui qu'il traite comme un clic droit, selon le paramètre « Bouton principal de la souris » de Windows : utilisez-les donc pour un clic ou un clic droit ordinaire. Left et Right sont les boutons physiques : lorsque les boutons principal et secondaire sont inversés dans les paramètres de la souris de Windows, un clic MouseButton.Left est le bouton gauche physique, que Windows traite comme un clic droit. ContextGetStrokeButton signale le bouton après inversion comme Primary ou Secondary : un geste du bouton droit signale donc Secondary quel que soit le bouton physique qui l'a tracé, et transmettre cette valeur à MouseClick appuie sur ce même bouton. Les macros enregistrées utilisent Primary et Secondary. |
FileNotify | FileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100 | filterMask de FolderWatchCreate. Ce sont des indicateurs binaires : combinez-les avec |. |
AudioEndpoint | Playback=0 Capture=1 Communications=2 | fonctions intégrées de volume et de sourdine 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 | verb de ShellRunProgram, qui accepte aussi tout autre verbe sous forme de Text |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | location de UIShowDisplayMessage, qui accepte aussi un point d'écran sous forme de Text "x,y" |
TextAlign | Left=0 Center=1 Right=2 | UIShowDisplayMessage/UIUpdateDisplayMessage |
LockResult | Acquired=0 TimedOut=1 Pinned=2 | renvoyé par UtilityLockAcquire/UtilityLockAcquirePinned |
LockState | Free=0 HeldByMe=1 HeldByOther=2 Pinned=3 | renvoyé par 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. Tous sauf FileStamp suivent les paramètres régionaux Windows de l'utilisateur, dans le calendrier propre à cette région ; FileStamp est toujours de la forme 20261001-140509, qui se trie par ordre chronologique et peut figurer sans risque dans un nom de fichier. |
DateTimePart | Year=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6 | DateTimeGetPart. Calendrier grégorien, heure locale. Weekday suit la norme ISO : 1 est le lundi, 7 le dimanche. |
VirtualKey | les codes de touche virtuelle Win32, nommés d'après l'énumération Keys de .NET (liste ci-dessous) | chaque fonction intégrée Keyboard* qui prend un Integer key |
Membres de VirtualKey
Les touches Oem* sont nommées d'après le symbole qu'elles produisent sur un clavier américain. La
touche physique varie selon la disposition du clavier.
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
Texte des combinaisons de touches (KeyboardPressKeyCombo)
KeyboardPressKeyCombo prend un Text, pas une constante : un nombre quelconque de préfixes de
modificateurs, puis exactement une touche. Une combinaison par appel, sans nombre de répétitions.
Rien ne peut suivre la touche : "^cx" ou "Control+V" est une erreur, et non un appui sur la
première touche.
| Préfixe | ^ | + | % | @ |
|---|---|---|---|---|
| Modificateur | Ctrl | Maj | Alt | Win |
La touche est une seule lettre ou un seul chiffre (majuscule ou minuscule), ou l'un de ces noms entre
accolades, quelle que soit la casse : {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} et {DELETE} fonctionnent aussi.
Exemples : "^c" Ctrl+C · "^+{ESC}" Ctrl+Maj+Échap · "%{F4}" Alt+F4 · "@d" Win+D ·
"^{HOME}" Ctrl+Origine · "{enter}" Entrée.
Vous connaissez SendKeys de .NET ? Les préfixes et les noms entre accolades suivent la
syntaxe de SendKeys de Microsoft. Ce
texte ajoute @ pour la touche Windows, et {NUMPAD0}…{NUMPAD9}, {SEPARATOR} et {DECIMAL} pour les
touches propres au pavé numérique. Il omet les nombres de répétitions ({LEFT 4}), plusieurs touches dans un
même texte ("^s{ENTER}"), les groupes entre parenthèses ("+(ec)"), ~ pour Entrée, les caractères
littéraux entre accolades comme {+}, et les noms courts {BKSP} et {INS}.