Structure NONCLIENTMETRICSW (winuser.h)

Article
11/20/2024

Contient les métriques évolutives associées à la zone non cliente d’une fenêtre nonminimisée. Cette structure est utilisée par les actions SPI_GETNONCLIENTMETRICS et SPI_SETNONCLIENTMETRICS de la fonction SystemParametersInfo .

Syntaxe

typedef struct tagNONCLIENTMETRICSW {
  UINT     cbSize;
  int      iBorderWidth;
  int      iScrollWidth;
  int      iScrollHeight;
  int      iCaptionWidth;
  int      iCaptionHeight;
  LOGFONTW lfCaptionFont;
  int      iSmCaptionWidth;
  int      iSmCaptionHeight;
  LOGFONTW lfSmCaptionFont;
  int      iMenuWidth;
  int      iMenuHeight;
  LOGFONTW lfMenuFont;
  LOGFONTW lfStatusFont;
  LOGFONTW lfMessageFont;
  int      iPaddedBorderWidth;
} NONCLIENTMETRICSW, *PNONCLIENTMETRICSW, *LPNONCLIENTMETRICSW;

Membres

cbSize

Taille de la structure, en octets. L’appelant doit définir cette valeur sur sizeof(NONCLIENTMETRICS). Pour plus d’informations sur la compatibilité des applications, consultez Remarques.

iBorderWidth

Épaisseur de la bordure de dimensionnement, en pixels. La valeur par défaut est de 1 pixel.

iScrollWidth

Largeur d’une barre de défilement verticale standard, en pixels.

iScrollHeight

Hauteur d’une barre de défilement horizontale standard, en pixels.

iCaptionWidth

Largeur des boutons de légende, en pixels.

iCaptionHeight

Hauteur des boutons de légende, en pixels.

lfCaptionFont

Structure LOGFONT qui contient des informations sur la police de légende.

iSmCaptionWidth

Largeur des petits boutons de légende, en pixels.

iSmCaptionHeight

Hauteur des petites légendes, en pixels.

lfSmCaptionFont

Structure LOGFONT qui contient des informations sur la police de petite légende.

iMenuWidth

Largeur des boutons de barre de menus, en pixels.

iMenuHeight

Hauteur d’une barre de menus, en pixels.

lfMenuFont

Structure LOGFONT qui contient des informations sur la police utilisée dans les barres de menus.

lfStatusFont

Structure LOGFONT qui contient des informations sur la police utilisée dans les barres d’état et les info-bulles.

lfMessageFont

Structure LOGFONT qui contient des informations sur la police utilisée dans les boîtes de message.

iPaddedBorderWidth

Épaisseur de la bordure rembourrée, en pixels. La valeur par défaut est de 4 pixels. Les membres iPaddedBorderWidth et iBorderWidth sont combinés pour les fenêtres redimensionnables et non accessibles dans l’expérience de bureau Windows Aero. Pour compiler une application qui utilise ce membre, définissez _WIN32_WINNT en tant que 0x0600 ou version ultérieure. Pour plus d’informations, consultez Remarques.

Windows Server 2003 et Windows XP/2000 : Ce membre n’est pas pris en charge.

Remarques

Si le membre iPaddedBorderWidth membre de la structure NONCLIENTMETRICS est présent, cette structure est supérieure à 4 octets pour une application compilée avec _WIN32_WINNT inférieure ou égale à 0x0502. Pour plus d’informations sur la compilation conditionnelle, consultez Utilisation des en-têtes Windows.

Windows Server 2003 et Windows XP/2000 : Si une application compilée pour Windows Server 2008 ou Windows Vista doit également s’exécuter sur Windows Server 2003 ou Windows XP/2000, utilisez la fonction GetVersionEx pour vérifier la version du système d’exploitation au moment de l’exécution et, si l’application s’exécute sur Windows Server 2003 ou Windows XP/2000, soustraire la taille du membre iPaddedBorderWidth du membre cbSize de la structure NONCLIENTMETRICS avant d’appeler la fonction SystemParametersInfo .

Note

L’en-tête winuser.h définit NONCLIENTMETRICS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	winuser.h (include Windows.h)

Voir aussi

LOGFONT

SystemParametersInfo

Partager via