WINDOWPLACEMENT, structure (winuser.h)

Contient des informations sur l’emplacement d’une fenêtre à l’écran.

Syntaxe

typedef struct tagWINDOWPLACEMENT {
  UINT  length;
  UINT  flags;
  UINT  showCmd;
  POINT ptMinPosition;
  POINT ptMaxPosition;
  RECT  rcNormalPosition;
  RECT  rcDevice;
} WINDOWPLACEMENT;

Membres

length

Type : UINT

Longueur de la structure, en octets. Avant d’appeler les fonctions GetWindowPlacement ou SetWindowPlacement , définissez ce membre sur sizeof(WINDOWPLACEMENT).

GetWindowPlacement et SetWindowPlacement échouent si ce membre n’est pas défini correctement.

flags

Type : UINT

Indicateurs qui contrôlent la position de la fenêtre réduite et la méthode par laquelle la fenêtre est restaurée. Ce membre peut être une ou plusieurs des valeurs suivantes.

showCmd

Type : UINT

État d’affichage actuel de la fenêtre. Il peut s’agir de l’une des valeurs spécifiées dans le paramètre nCmdShow de la fonction ShowWindow.

ptMinPosition

Type : POINT

Coordonnées de l’angle supérieur gauche de la fenêtre lorsque la fenêtre est réduite.

ptMaxPosition

Type : POINT

Coordonnées de l’angle supérieur gauche de la fenêtre lorsque la fenêtre est agrandie.

rcNormalPosition

Type : RECT

Coordonnées de la fenêtre lorsque la fenêtre est dans la position restaurée.

rcDevice

Remarques

Si la fenêtre est une fenêtre de niveau supérieur qui n’a pas le style de fenêtre WS_EX_TOOLWINDOW , les coordonnées représentées par les membres suivants sont dans les coordonnées de l’espace de travail : ptMinPosition, ptMaxPosition et rcNormalPosition. Sinon, ces membres sont en coordonnées d’écran.

Les coordonnées de l’espace de travail diffèrent des coordonnées d’écran en ce qu’elles prennent en compte les emplacements et les tailles des barres d’outils d’application (y compris la barre des tâches). La coordonnée de l’espace de travail (0,0) est le coin supérieur gauche de la zone d’espace de travail, la zone de l’écran n’étant pas utilisée par les barres d’outils d’application.

Les coordonnées utilisées dans une structure WINDOWPLACEMENT doivent être utilisées uniquement par les fonctions GetWindowPlacement et SetWindowPlacement . Le passage de coordonnées d’espace de travail à des fonctions qui attendent des coordonnées d’écran (telles que SetWindowPos) entraîne l’affichage de la fenêtre au mauvais emplacement. Par exemple, si la barre des tâches se trouve en haut de l’écran, l’enregistrement des coordonnées de fenêtre à l’aide de GetWindowPlacement et leur restauration à l’aide de SetWindowPos fait apparaître la fenêtre pour « ramper » l’écran.

Spécifications

Voir aussi

Conceptuel

GetWindowPlacement

POINT

RECT

Référence

SetWindowPlacement

SetWindowPos

ShowWindow

Windows