Struttura NONCLIENTMETRICSA (winuser.h)

Articolo
03/13/2024

Contiene le metriche scalabili associate all'area nonclient di una finestra nonminimizzata. Questa struttura viene usata dalle azioni SPI_GETNONCLIENTMETRICS e SPI_SETNONCLIENTMETRICS della funzione SystemParametersInfo .

Sintassi

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;

Members

cbSize

Dimensioni della struttura, in byte. Il chiamante deve impostare questo valore su sizeof(NONCLIENTMETRICS). Per informazioni sulla compatibilità dell'applicazione, vedere Osservazioni.

iBorderWidth

Spessore del bordo di ridimensionamento, in pixel. Il valore predefinito è 1 pixel.

iScrollWidth

Larghezza di una barra di scorrimento verticale standard, in pixel.

iScrollHeight

Altezza di una barra di scorrimento orizzontale standard, in pixel.

iCaptionWidth

Larghezza dei pulsanti di didascalia, in pixel.

iCaptionHeight

Altezza dei pulsanti di didascalia, in pixel.

lfCaptionFont

Struttura LOGFONT che contiene informazioni sul tipo di carattere didascalia.

iSmCaptionWidth

Larghezza dei pulsanti di didascalia di piccole dimensioni, in pixel.

iSmCaptionHeight

Altezza di didascalie piccole, in pixel.

lfSmCaptionFont

Struttura LOGFONT che contiene informazioni sul tipo di carattere di didascalia di piccole dimensioni.

iMenuWidth

Larghezza dei pulsanti della barra dei menu, in pixel.

iMenuHeight

Altezza di una barra dei menu, in pixel.

lfMenuFont

Struttura LOGFONT che contiene informazioni sul tipo di carattere utilizzato nelle barre dei menu.

lfStatusFont

Struttura LOGFONT che contiene informazioni sul tipo di carattere usato nelle barre di stato e nelle descrizioni comandi.

lfMessageFont

Struttura LOGFONT che contiene informazioni sul tipo di carattere utilizzato nelle caselle di messaggio.

iPaddedBorderWidth

Spessore del bordo riempimento, in pixel. Il valore predefinito è 4 pixel. I membri iPaddedBorderWidth e iBorderWidth vengono combinati sia per le finestre ridimensionabili che per le finestre nonresizable nell'esperienza desktop di Windows Aero. Per compilare un'applicazione che usa questo membro, definire _WIN32_WINNT come 0x0600 o versione successiva. Per altre informazioni, vedere la sezione Osservazioni.

Windows Server 2003 e Windows XP/2000: Questo membro non è supportato.

Commenti

Se è presente il membro iPaddedBorderWidth della struttura NONCLIENTMETRICS , questa struttura è maggiore di 4 byte rispetto a un'applicazione compilata con _WIN32_WINNT minore o uguale a 0x0502 . Per altre informazioni sulla compilazione condizionale, vedere Uso delle intestazioni di Windows.

Windows Server 2003 e Windows XP/2000: Se un'applicazione compilata per Windows Server 2008 o Windows Vista deve essere eseguita anche in Windows Server 2003 o Windows XP/2000, usare la funzione GetVersionEx per controllare la versione del sistema operativo in fase di esecuzione e, se l'applicazione è in esecuzione in Windows Server 2003 o Windows XP/2000, sottraere le dimensioni del membro iPaddedBorderWidth dal membro cbSize della struttura NONCLIENTMETRICS prima di chiamare la funzione SystemParametersInfo .

Nota

L'intestazione winuser.h definisce NONCLIENTMETRICS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	winuser.h (include Windows.h)

Vedi anche

LOGFONT

Systemparametersinfo

Condividi tramite