Structure NONCLIENTMETRICSA (winuser.h)

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

Syntaxe

typedef struct tagNONCLIENTMETRICSA {
  UINT     cbSize;
  int      iBorderWidth;
  int      iScrollWidth;
  int      iScrollHeight;
  int      iCaptionWidth;
  int      iCaptionHeight;
  LOGFONTA lfCaptionFont;
  int      iSmCaptionWidth;
  int      iSmCaptionHeight;
  LOGFONTA lfSmCaptionFont;
  int      iMenuWidth;
  int      iMenuHeight;
  LOGFONTA lfMenuFont;
  LOGFONTA lfStatusFont;
  LOGFONTA lfMessageFont;
  int      iPaddedBorderWidth;
} NONCLIENTMETRICSA, *PNONCLIENTMETRICSA, *LPNONCLIENTMETRICSA;

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 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 de légende boutons, 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 la 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 status barres et 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 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é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 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 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. La combinaison 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