Aller au contenu principal

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 nomsMembres = valeurUtilisé par
MouseButtonLeft=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6MouseClick, 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.
FileNotifyFileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100filterMask de FolderWatchCreate. Ce sont des indicateurs binaires : combinez-les avec |.
AudioEndpointPlayback=0 Capture=1 Communications=2fonctions intégrées de volume et de sourdine Multimedia*
WindowStyleNormal=0 Minimized=1 Maximized=2 Hidden=3ShellRunProgram
ShellVerbOpen=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6verb de ShellRunProgram, qui accepte aussi tout autre verbe sous forme de Text
LocationTopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8location de UIShowDisplayMessage, qui accepte aussi un point d'écran sous forme de Text "x,y"
TextAlignLeft=0 Center=1 Right=2UIShowDisplayMessage/UIUpdateDisplayMessage
LockResultAcquired=0 TimedOut=1 Pinned=2renvoyé par UtilityLockAcquire/UtilityLockAcquirePinned
LockStateFree=0 HeldByMe=1 HeldByOther=2 Pinned=3renvoyé par UtilityLockGetState
SerialParityNone=0 Odd=1 Even=2 Mark=3 Space=4SerialOpenPort, SerialMonitorCreate
SerialStopBitsOne=0 OnePointFive=1 Two=2SerialOpenPort, SerialMonitorCreate
DateTimeStyleShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6DateTimeFormat. 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.
DateTimePartYear=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6DateTimeGetPart. Calendrier grégorien, heure locale. Weekday suit la norme ISO : 1 est le lundi, 7 le dimanche.
VirtualKeyles 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^+%@
ModificateurCtrlMajAltWin

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}.