Estructura NONCLIENTMETRICSA (winuser.h)

Contiene las métricas escalables asociadas al área no cliente de una ventana no minimizada. Esta estructura la usan las acciones SPI_GETNONCLIENTMETRICS y SPI_SETNONCLIENTMETRICS de la función SystemParametersInfo de .

Sintaxis

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;

Miembros

cbSize

Tamaño de la estructura, en bytes. El autor de la llamada debe establecerlo en sizeof(NONCLIENTMETRICS). Para obtener información sobre la compatibilidad de aplicaciones, vea Comentarios.

iBorderWidth

Grosor del borde de ajuste de tamaño, en píxeles. El valor predeterminado es de 1 píxel.

iScrollWidth

Ancho de una barra de desplazamiento vertical estándar, en píxeles.

iScrollHeight

Alto de una barra de desplazamiento horizontal estándar, en píxeles.

iCaptionWidth

Ancho de los botones de título, en píxeles.

iCaptionHeight

Alto de los botones de título, en píxeles.

lfCaptionFont

Estructura LOGFONT que contiene información sobre la fuente del título.

iSmCaptionWidth

Ancho de los botones de título pequeños, en píxeles.

iSmCaptionHeight

Alto de títulos pequeños, en píxeles.

lfSmCaptionFont

Estructura LOGFONT que contiene información sobre la fuente de título pequeño.

iMenuWidth

Ancho de los botones de la barra de menús, en píxeles.

iMenuHeight

Alto de una barra de menús, en píxeles.

lfMenuFont

Estructura LOGFONT que contiene información sobre la fuente usada en las barras de menús.

lfStatusFont

Estructura LOGFONT que contiene información sobre la fuente usada en las barras de estado y la información sobre herramientas.

lfMessageFont

Estructura LOGFONT que contiene información sobre la fuente usada en los cuadros de mensaje.

iPaddedBorderWidth

Grosor del borde acolchado, en píxeles. El valor predeterminado es de 4 píxeles. Los iPaddedBorderWidth y miembros de iBorderWidth se combinan para ventanas redimensionables y noizables en la experiencia de escritorio de Windows Aero. Para compilar una aplicación que use este miembro, defina _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Comentarios.

Windows Server 2003 y Windows XP/2000: Este miembro no es compatible.

Observaciones

Si el iPaddedBorderWidth miembro del estructura NONCLIENTMETRICS está presente, esta estructura es de 4 bytes mayor que para una aplicación compilada con _WIN32_WINNT menor o igual que 0x0502. Para obtener más información sobre la compilación condicional, vea Using the Windows Headers.

Windows Server 2003 y Windows XP/2000: Si una aplicación compilada para Windows Server 2008 o Windows Vista también debe ejecutarse en Windows Server 2003 o Windows XP/2000, use la función GetVersionEx para comprobar la versión del sistema operativo en tiempo de ejecución y, si la aplicación se ejecuta en Windows Server 2003 o Windows XP/2000, resta el tamaño del miembro iPaddedBorderWidth del miembro cbSize del NONCLIENTMETRICS antes de llamar a la función SystemParametersInfo.

Nota

El encabezado winuser.h define NONCLIENTMETRICS como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	winuser.h (incluya Windows.h)

Consulte también

LOGFONT

SystemParametersInfo