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 windows = Window.all(); for(var i = 0; i < windows.length; ++i) Console.print(windows[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 windows = Window.find({ title: "Notepad" });
Trouvez les fenêtres dont le titre commence par "Notepad", utilisant des jokers.
var windows = 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");