WINDOWPLACEMENT, structure (winuser.h)

Article
08/28/2023

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.

Valeur	Signification
WPF_ASYNCWINDOWPLACEMENT 0x0004	Si le thread appelant et le thread propriétaire de la fenêtre sont attachés à différentes files d’attente d’entrée, le système publie la demande sur le thread propriétaire de la fenêtre. Cela empêche le thread appelant de bloquer son exécution pendant que d’autres threads traitent la requête.
WPF_RESTORETOMAXIMIZED 0x0002	La fenêtre restaurée est agrandie, qu’elle ait été agrandie ou non avant d’être réduite. Ce paramètre n’est valide que la prochaine fois que la fenêtre est restaurée. Il ne modifie pas le comportement de restauration par défaut. Cet indicateur n’est valide que lorsque la valeur SW_SHOWMINIMIZED est spécifiée pour le membre showCmd .
WPF_SETMINPOSITION 0x0001	Les coordonnées de la fenêtre réduite peuvent être spécifiées. Cet indicateur doit être spécifié si les coordonnées sont définies dans le membre ptMinPosition .

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


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)