Window

Objet de gestion de fenêtre qui peut être utilisé pour représenter une fenêtre sur le bureau.

Fonction constructeur.

var monObjet = new Window();

var monObjet = new Window(otherWindow);

1. otherWindow - (Window) autre fenêtre pour copier

• (ParameterTypeError) Type de paramètre incorrect
• (ParameterCountError) Nombre de paramètres incorrectes

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);

Retourne un tableau de la fenêtre représentant l'ensemble des fenêtres sur le bureau.

Window.all();

• (array) un tableau de fenêtre

Cet exemple permet d'imprimer tous les titres des fenêtres dans la console.

var fenetres = Window.all();
for(var i = 0; i < fenetres.length; ++i)
    Console.print(fenetres[i].title() + "\n");

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.

Window.find(paramètres);

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

• (array) un tableau de la fenêtre trouvés

• (ProcessHandleError) invalides ProcessHandle

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");

Retourne une copie de cette fenêtre.

monObjet.clone();

• (Window) une copie de cette fenêtre

var copyDeMonObjet = monObjet.clone();

Retourne vrai si cette fenêtre et l'autre sont la même fenêtre.

monObjet.equals(autres);

1. Autres - (Window) une autre fenêtre

• (bool) vrai si Autres est référençant la même fenêtre

if(monPremierObjet.equals(monDeuxiemeObjet))
	//Faire quelque chose

Renvoie une chaîne représentant cette fenêtre.

monObjet.toString();

• (string) une chaîne représentant cette fenêtre

Console.print(monObjet.toString());

Cette méthode est appelée automatiquement lorsque vous essayez de convertir une fenêtre à une chaîne.

Retourne vrai si cette fenêtre est une fenêtre de référencement, sinon retourne faux.

monObjet.isValid();

• (bool) vrai si cette fenêtre est une fenêtre de référencement

if(monObjet.isValid())
	//Faire quelque chose

Retourne le titre de la fenêtre actuelle.

monObjet.title();

• (string) le titre de la fenêtre référencé

• (InvalidWindowError) fenêtre invalides

Console.print(monObjet.title());

Retourne le nom de la classe de la fenêtre courante.

monObjet.className();

• (string) le nom de classe de la fenêtre référencé

• (InvalidWindowError) fenêtre invalides

Console.print(monObjet.className());

Retourne vrai si cette fenêtre est la fenêtre au premier plan, sinon retourne faux.

monObjet.isActive();

• (bool) vrai si cette fenêtre est la fenêtre au premier plan

• (InvalidWindowError) fenêtre invalides

Retourne un Rect représentant le rectangle de la fenêtre.

monObjet.rect();

monObjet.rect(utiliseLesBordures);

- utiliseLesBordures - (bool) prend en compte les bordures de la fenêtre (valeur par défaut : vrai) [Ajouté dans Actionaz 3.2.0.]

• (Rect) un Rect représentant le rectangle de la fenêtre

• (InvalidWindowError) fenêtre invalides

Retourne un ProcessHandle représentant le processus propriétaire de la fenêtre.

myObject.process();

• (ProcessHandle) un ProcessHandle représentant le processus propriétaire de la fenêtre

• (InvalidWindowError) fenêtre invalides

Ferme une fenêtre.

monObjet.close();

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (CloseWindowError) incapable de fermer la fenêtre

Tuez le processus propriétaire de cette fenêtre.

monObjet.killCreator();

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (KillCreatorError) incapables de tuer le propriétaire de la fenêtre

Définir cette fenêtre au premier plan.

monObjet.setForeground();

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (SetForegroundError) incapable de définir cette fenêtre au premier plan

Réduit la fenêtre.

monObjet.minimize();

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (MinimizeError) incapable de réduire la fenêtre

Maximise la fenêtre.

monObjet.maximize();

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (MaximizeError) incapable de maximiser la fenêtre

Déplace la fenêtre.

monObjet.move(point);

1. point - (Point) point où déplacer la fenêtre

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (MoveError) incapable de déplacer la fenêtre

Redimensionnez la fenêtre.

monObjet.resize(taille);

monObjet.resize(taille, utiliseLesBordures);

1. taille - (Size) la nouvelle taille de la fenêtre
2. utiliseLesBordures - (bool) prend en compte les bordures de la fenêtre (valeur par défaut : vrai) [Ajouté dans Actionaz 3.2.0.]

• (Window) cette fenêtre

• (InvalidWindowError) fenêtre invalides
• (ResizeError) incapable de redimensionner la fenêtre

Match modes pour la fonction find.

1. RegExp: recherche en utilisant les expressions régulières
2. Wildcard: recherche en utilisant des métacaractères (Wildcards)
3. WildcardUnix: recherche en utilisant des métacaractères (Wildcards) de type Unix
4. FixedString: utilise une chaîne fixe

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
});