Table des matières
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ées:
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) une chaîne représentant cette fenêtre
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());
className
Retourne le nom de la classe de la fenêtre courante.
Syntaxe
monObjet.className();
Renvoie
- (string) le nom de classe de la fenêtre référencé
Exceptions
- (InvalidWindowError) fenêtre invalides
Exemple
Console.print(monObjet.className());
isActive
Retourne vrai si cette fenêtre est la fenêtre au premier plan, sinon retourne faux.
Syntaxe
monObjet.isActive();
Renvoie
- (bool) vrai si cette fenêtre est la fenêtre au premier plan
Exceptions
- (InvalidWindowError) fenêtre invalides
rect
Retourne un Rect représentant le rectangle de la fenêtre.
Syntaxe
monObjet.rect();
monObjet.rect(utiliseLesBordures);
Arguments
- utiliseLesBordures - (bool) prend en compte les bordures de la fenêtre (valeur par défaut : vrai) [Ajouté dans Actionaz 3.2.0.]
Renvoie
- (Rect) un Rect représentant le rectangle de la fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
process
Retourne un ProcessHandle représentant le processus propriétaire de la fenêtre.
Syntaxe
myObject.process();
Renvoie
- (ProcessHandle) un ProcessHandle représentant le processus propriétaire de la fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
close
Ferme une fenêtre.
Syntaxe
monObjet.close();
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (CloseWindowError) incapable de fermer la fenêtre
killCreator
Tuez le processus propriétaire de cette fenêtre.
Syntaxe
monObjet.killCreator();
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (KillCreatorError) incapables de tuer le propriétaire de la fenêtre
setForeground
Définir cette fenêtre au premier plan.
Syntaxe
monObjet.setForeground();
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (SetForegroundError) incapable de définir cette fenêtre au premier plan
minimize
Réduit la fenêtre.
Syntaxe
monObjet.minimize();
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (MinimizeError) incapable de réduire la fenêtre
maximize
Maximise la fenêtre.
Syntaxe
monObjet.maximize();
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (MaximizeError) incapable de maximiser la fenêtre
move
Déplace la fenêtre.
Syntaxe
monObjet.move(point);
Arguments
- point - (Point) point où déplacer la fenêtre
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (MoveError) incapable de déplacer la fenêtre
resize
Redimensionnez la fenêtre.
Syntaxe
monObjet.resize(taille);
monObjet.resize(taille, utiliseLesBordures);
Arguments
- taille - (Size) la nouvelle taille de la fenêtre
- utiliseLesBordures - (bool) prend en compte les bordures de la fenêtre (valeur par défaut : vrai) [Ajouté dans Actionaz 3.2.0.]
Renvoie
- (Window) cette fenêtre
Exceptions
- (InvalidWindowError) fenêtre invalides
- (ResizeError) incapable de redimensionner la fenêtre
Enumerations
Match mode
Match modes pour la fonction find.
Valeurs
- RegExp: recherche en utilisant les expressions régulières
- Wildcard: recherche en utilisant des métacaractères (Wildcards)
- WildcardUnix: recherche en utilisant des métacaractères (Wildcards) de type Unix
- FixedString: utilise une chaîne fixe
Exemple
Trouvez les fenêtres dont le titre commence par "Notepad", utilisant des métacaractères (Wildcards).
var fenetres = Window.find({ title: "Notepad*", titleMode: Window.Wildcard });