Outils pour utilisateurs

Outils du site


fr:code:core:window

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

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

  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

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

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

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

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

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

  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

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
});
fr/code/core/window.txt · Dernière modification : 2021/02/13 11:23 de 127.0.0.1