Lire en anglais

Partager via


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.

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)

Voir aussi

Conceptuel

GetWindowPlacement

POINT

RECT

Référence

SetWindowPlacement

SetWindowPos

ShowWindow

Windows