Titre et texte d'une fenêtre (Avancé)

AutoIt fonctionne selon l'un des 4 modes de "correspondance à une fenêtre".  Ces modes sont réglés par la fonction AutoItSetOption en utilisant l'option WinTitleMatchMode.

Mode 1 (Par défaut)

Correspondance partielle du début du titre.

Dans ce mode une fenêtre intitulée Sans titre - Bloc-notes pourrait être trouvée par le titre "Sans titre - Bloc-notes", "Sans titre", "Sans", etc. 

Exemple :

WinWait("Sans titre")

Mode 2

Correspondance avec n'importe quelle sous-chaîne.

Dans ce mode, une fenêtre intitulée Sans titre - Bloc-notes pourrait être trouvée par le titre "Sans titre - Bloc-notes", "Sans titre", "Bloc-notes", "pad", etc.

Exemple :

WinWait("Bloc-notes")

Mode 3

Correspondance exacte.

Dans ce mode, une fenêtre intitulée Sans titre - Bloc-notes ne pourra être identifiée qu'en spécifiant le titre exact "Sans titre - Bloc-notes"

Mode 4 (Conservé pour la rétro-compatibilité)

Mode avancé.

Doit être remplacé par la description avancée des fenêtres qui évite la définition d'un mode.

Mode -1 à -3

Force la correspondance en minuscule en accord avec les autres type de correspondance.

Description Avancée des Fenêtres

Une description spéciale peux être utilisée comme paramètre de titre de la fenêtre. Cette description peux être utilisée pour identifier la fenêtre par les propriétés suivantes :

• TITLE - Le titre de la fenêtre
• CLASS - Le nom de la class interne à window (classname)
• REGEXPTITLE -cLe titre de la fenêtre en utilisant une expression régulière (Si l'expression régulière est fausse alors @error sera fixé à 2)
• REGEXPCLASS - Classname d'une fenêtre utilisant une expression régulière
• LAST - La dernière fenêtre utilisée dans une commande précédente de AutoIt
• ACTIVE - La fenêtre courrante active
• X \ Y \ W \ H - La position et la taille d'une fenêtre.
• INSTANCE - La première instance lorsque toutes les propriétées correspondes

Une ou plusieurs propriétées peuvent être utilisées comme paramètre titre d'une commande de fenêtre comme ceci :

[PROPERTY1:Value1; PROPERTY2:Value2]

Si une valeur doit contenir un ";" il doit être doublé.

Exemple : Attend une fenêtre dont la classname est "Bloc-notes"

WinWaitActive("[CLASS:Bloc-notes]", "")

Exemple : Liste les fenêtres correspondantes à une classname définie par une expression régulière

WinList("[REGEXPCLASS:#\d+]")

Exemple : Ferme la fenêtre courrante active

WinClose("[ACTIVE]", "")

Exemple : Attend la deuxième instance d'une fenêtre dont le titre est "Ma fenêtre" et de classname "Ma Class"

WinWaitActive("[TITLE:Ma fenêtre; CLASS:Ma Class; INSTANCE:2]", "")

Handles / HWNDs d'une fenêtre

Les différents typages de données dans AUtoIt supportent nativement les handles de fenêtre (HWNDs). Le handle d'une fenêtre est une valeur spécifique que Windows attribue a une fenêtre chaque fois qu'elle est créée. Quand vous avez un handle, vous pouvez l'utiliser en lieu et place du paramètre de titre dans n'importe quel appel de fonction qui utilise la convention title/text. L'avantage d'utiliser les handles de fenêtre est que si vous avez plusieurs copies d'une application ouverte - Qui ont le même titre/texte - Vous pouvez les identifiées par leur handle. Lorsque vous utilisez le handle d'une fenêtre comme paramètre de titre alors le texte est complètement ignoré.

Divers fonctions tel que WinGetHandle, WinList et GUICreate revoie ce handle. Il est important de noter que le handle d'une fenêtre n'est pas classé comme un nombre ou une chaîne mais comme sont propre type.

Note: Les handles de fenêtres fonctionneront quelque soit le mode attribué à WinTitleMatchMode.

Exemple :

$handle = WinGetHandle("Sans titre - Bloc-notes", "")
WinClose($handle)