SET WINDOW RECT

SET WINDOW RECT ( gauche ; haut ; droite ; bas {; fenêtre}{; *} )

Paramètre	Type		Description
gauche	Integer	→	Coordonnée gauche de l'intérieur de la fenêtre
haut	Integer	→	Coordonnée supérieure de l'intérieur de la fenêtre
droite	Integer	→	Coordonnée droite de l'intérieur de la fenêtre
bas	Integer	→	Coordonnée inférieure de l'intérieur de la fenêtre
fenêtre	Integer	→	Numéro de référence de la fenêtre ou Fenêtre de premier plan du process si ce paramètre est omis
*	Opérateur	→	Si omis (défaut) = passer la fenêtre au premier plan Si passé = ne pas changer le plan de la fenêtre

Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.

Description

La commande SET WINDOW RECT modifie les coordonnées globales de la fenêtre dont vous avez passé le numéro de référence RefFen dans le paramètre fenêtre. Si la fenêtre n'existe pas, la commande ne fait rien.

Si vous omettez le paramètre fenêtre, SET WINDOW RECT s'applique à la fenêtre de premier plan du process courant.

Ces coordonnées doivent être exprimées relativement au coin supérieur gauche de la zone de contenu de la fenêtre d'application (sous Windows en mode MDI) ou de l'écran principal (sous macOS et Windows en mode SDI). Les coordonnées décrivent le rectangle correspondant à la zone de contenu de la fenêtre (en excluant les barres de titres et les bordures).

Attention : Utilisez cette commande avec précaution, car vous pouvez déplacer une fenêtre en-dehors des limites de la fenêtre principale (sous Windows) ou de l'écran (sous Mac OS). Pour éviter cela, vous pouvez utiliser des fonctions telles que Screen width et Screen height pour bien vérifier les nouvelles coordonnées de la fenêtre.

Par défaut, l’exécution de la commande fait automatiquement passer au premier plan la fenêtre désignée par le paramètre fenêtre (lorsque ce paramètre est utilisé). Vous pouvez inactiver ce fonctionnement en passant * en dernier paramètre. Dans ce cas, la commande ne modifie pas le plan initial de la fenêtre (coordonnée "z").

Cette commande n’affecte pas les objets du formulaire. Si la fenêtre contient un formulaire, les objets du formulaire ne sont pas déplacés ou redimensionnés par la commande (quelles que soient leurs propriétés). Seule la fenêtre est modifiée. Pour modifier une fenêtre de formulaire en tenant compte de ses propriétés de redimensionnement et des objets qu’elle contient, vous devez utiliser la commande RESIZE FORM WINDOW.

Exemple 1

Reportez-vous à l'exemple de la commande WINDOW LIST.

Exemple 2

Soit la fenêtre suivante :

Après l'exécution de la ligne suivante :

 SET WINDOW RECT(100;100;300;300)

La fenêtre apparaît ainsi :

Voir aussi

CONVERT COORDINATES
DRAG WINDOW
GET WINDOW RECT
RESIZE FORM WINDOW