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) |