Structure NONCLIENTMETRICSW (winuser.h)

Article
08/28/2023

Contient les métriques évolutives associées à la zone non client 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 légende, en pixels.

iCaptionHeight

Hauteur de légende boutons, en pixels.

lfCaptionFont

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

iSmCaptionWidth

Largeur des petits boutons 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 de status et les info-bulles.

lfMessageFont

Structure LOGFONT qui contient des informations sur la police utilisée dans les zones 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 redimensionnables dans l’expérience de bureau Windows Aero. Pour compiler une application qui utilise ce membre, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d'informations, consultez la section Notes.

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

Remarques

Si le membre iPaddedBorderWidth de la structure NONCLIENTMETRICS est présent, cette structure est supérieure de 4 octets à celle d’une application compilée avec _WIN32_WINNT inférieur ou égal à 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 case activée 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, soustrayez la taille du membre iPaddedBorderWidth du membre cbSize de la structure NONCLIENTMETRICS avant d’appeler le Fonction SystemParametersInfo.

Notes

L’en-tête winuser.h définit NONCLIENTMETRICS comme un 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.

Configuration requise

Condition requise	Valeur
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

LOGFONT

SystemParametersInfo

Partager via