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 .

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

El 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 subtítulo botones, en píxeles.

iCaptionHeight

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

lfCaptionFont

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

iSmCaptionWidth

Ancho de los botones de subtí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 pequeña subtítulo.

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 utilizada en las barras de menú.

lfStatusFont

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

lfMessageFont

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

iPaddedBorderWidth

Grosor del borde acolchado, en píxeles. El valor predeterminado es de 4 píxeles. Los miembros iPaddedBorderWidth e iBorderWidth se combinan para ventanas redimensionables y no ajustables 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 la sección Comentarios.

Windows Server 2003 y Windows XP/2000: Este miembro no se admite.

Comentarios

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

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 de la estructura 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluya Windows.h)

Consulte también

LOGFONT

SystemParametersInfo