Ceci est une ancienne révision du document !
Window
Objet de gestion de fenêtre qui peut être utilisé pour représenter une fenêtre sur le bureau.
Fonctions
Window
Fonction constructeur.
Syntaxe
var monObjet = new Window();
var monObjet = new Window(otherWindow);
Arguments
- otherWindow - (Window) autre fenêtre pour copier
Exceptions
- (ParameterTypeError) Type de paramètre incorrect
- (ParameterCountError) Nombre de paramètres incorrectes
Exemple
Créer une fenêtre non valide.
var monObjet = new Window();
Créer une fenêtre représentant une copie de otherWindow.
var monObjet = new Window(otherWindow);
all
Retourne un tableau de la fenêtre représentant l'ensemble des fenêtres sur le bureau.
Syntaxe
Window.all();
Renvoie
- (array) un tableau de fenêtre
Exemple
Cet exemple permet d'imprimer tous les titres des fenêtres dans la console.
var fenetres = Window.all(); for(var i = 0; i < windows.length; ++i) Console.print(fenetre[i].title() + "\n");
find
Recherches des fenêtres correspondant à certains critères. Tout critère omis n'est pas utilisé. Seules les fenêtres correspondant à tous les critères sont retournés.
Syntaxe
Window.find(paramètres);
Arguments
- paramètres - (object) paramètres de recherche
- title - (string) titre de la fenêtre
- titleMode - (enum) voir match modes pour la liste des valeurs possibles
- titleCaseSensitive - (bool) réglez ce paramètre sur vrai si vous voulez le titre correspondant à la casse
- className - (string) nom de classe de la fenêtre
- classNameMode - (enum) voir match modes pour la liste des valeurs possibles
- classNameCaseSensitive - (bool) réglez ce paramètre sur vrai si vous voulez le nom de classe correspondant à la casse
- processId - (integer) définir cela à un ID de processus pour obtenir les fenêtres uniquement détenue par ce processus
- process - (ProcessHandle) définir cela à une instance d'un ID de ProcessHandle pour obtenir les fenêtres uniquement détenue par ce processus
Renvoie
- (array) un tableau de la fenêtre trouvés
Exceptions
- (ProcessHandleError) invalides ProcessHandle
Exemple
Trouvez la fenêtre appelée «Notepad».
var fenetres = Window.find({ title: "Notepad" });
Trouve les fenêtres dont le titre commence par “Notepad”, en utilisant des métacaractères (wildcards).
var fenetres = Window.find({ title: "Notepad*", titleMode: Window.Wildcard });
Vous pouvez utiliser le code suivant pour afficher le nom de toutes les fenêtres trouvés:
for(var i = 0; i < windows.length; ++i) Console.print(windows[i].title() + "\n");
Méthodes
clone
Retourne une copie de cette fenêtre.
Syntaxe
monObjet.clone();
Renvoie
- (Window) une copie de cette fenêtre
Exemple
var copyDeMonObjet = monObjet.clone();
equals
Retourne vrai si cette fenêtre et l'autre sont la même fenêtre.
Syntaxe
monObjet.equals(autres);
Arguments
- Autres - (Window) une autre fenêtre
Renvoie
- (bool) vrai si Autres est référençant la même fenêtre
Exemple
if(monPremierObjet.equals(monDeuxiemeObjet)) //Faire quelque chose
toString
Renvoie une chaîne représentant cette fenêtre.
Syntaxe
monObjet.toString();
Renvoie
- (string) a string representing this Window
Exemple
Console.print(monObjet.toString());
Notes
Cette méthode est appelée automatiquement lorsque vous essayez de convertir une fenêtre à une chaîne.
isValid
Retourne vrai si cette fenêtre est une fenêtre de référencement, sinon retourne faux.
Syntaxe
monObjet.isValid();
Renvoie
- (bool) vrai si cette fenêtre est une fenêtre de référencement
Exemple
if(monObjet.isValid()) //Faire quelque chose
title
Retourne le titre de la fenêtre actuelle.
Syntaxe
monObjet.title();
Renvoie
- (string) le titre de la fenêtre référencé
Exceptions
- (InvalidWindowError) fenêtre invalides
Exemple
Console.print(monObjet.title());