Functions > Window >


WinGetPos

Obtient la position et la taille d'une fenêtre donnée.

WinGetPos ( "title" [, "text"] )

Paramètres

title Le titre/hWnd/class de la fenêtre à traiter. Consultez Définition spéciale de titre.
text [optionnel] Le texte de la fenêtre à traiter. La valeur par défaut est une chaîne vide. Consultez Définition spéciale de texte.

Valeur de retour

Succès: Retourne un tableau de 4 éléments contenant les informations suivantes :
    [0] = Coordonnée X du coin supérieur gauche
    [1] = Coordonnée Y du coin supérieur gauche
    [2] = Largeur
    [3] = Hauteur
Échec: Définit @error <> 0 si la fenêtre n'est pas trouvée.

Remarques

WinGetPos() retourne des nombres négatifs tels que -32000 pour les fenêtres minimisées, mais fonctionne très bien avec des fenêtres masquées (non réduites).
Si le titre "Program Manager" est utilisé, la fonction retourne la taille du bureau. Si plusieurs fenêtres correspondent aux critères, la fenêtre active la plus récente est utilisée.

En relation

WinGetClientSize, WinGetState, WinMove

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Récupére la position ainsi que la hauteur et la largeur de la fenêtre active.
    Local $aPos = WinGetPos("[ACTIVE]")

    ; Affiche les valeurs du tableau retourné par WinGetPos.
    MsgBox($MB_SYSTEMMODAL, "", "X-Pos: " & $aPos[0] & @CRLF & _
            "Y-Pos: " & $aPos[1] & @CRLF & _
            "Width: " & $aPos[2] & @CRLF & _
            "Height: " & $aPos[3])
EndFunc   ;==>Example