NONCLIENTMETRICSA 結構 （winuser.h）

包含與非最小化視窗之非工作區相關聯的可調整計量。 SystemParametersInfo 函式的 SPI_GETNONCLIENTMETRICS 和 SPI_SETNONCLIENTMETRICS 動作會使用此結構。

語法

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;

成員

cbSize

結構的大小，以位元組為單位。 呼叫端必須將此設定為 sizeof(NONCLIENTMETRICS)。 如需應用程式相容性的相關信息，請參閱。

iBorderWidth

重設大小框線的粗細，以像素為單位。 預設值為 1 像素。

iScrollWidth

標準垂直滾動條的寬度，以像素為單位。

iScrollHeight

標準水準滾動條的高度，以像素為單位。

iCaptionWidth

標題按鈕的寬度，以像素為單位。

iCaptionHeight

標題按鈕的高度，以像素為單位。

lfCaptionFont

LOGFONT 結構，其中包含標題字型的相關信息。

iSmCaptionWidth

小標題按鈕的寬度，以像素為單位。

iSmCaptionHeight

小標題的高度，以像素為單位。

lfSmCaptionFont

LOGFONT 結構，其中包含小標題字型的相關信息。

iMenuWidth

功能表欄按鈕的寬度，以像素為單位。

iMenuHeight

功能表欄的高度，以像素為單位。

lfMenuFont

LOGFONT 結構，其中包含功能表欄中使用的字型相關信息。

lfStatusFont

LOGFONT 結構，其中包含狀態列和工具提示中所用字型的相關信息。

lfMessageFont

LOGFONT 結構，其中包含消息框中所用字型的相關信息。

iPaddedBorderWidth

邊框間距的粗細，以像素為單位。 預設值為 4 像素。 iPaddedBorderWidth 和 iBorderWidth 成員會針對 Windows Aero 桌面體驗中的可重設大小和不可還原的窗口合併。 若要編譯使用此成員的應用程式，請將 _WIN32_WINNT 定義為0x0600或更新版本。 如需詳細資訊，請參閱。

Windows Server 2003 和 Windows XP/2000：不支援此成員 。

言論

如果 NONCLIENTMETRICS 結構的 iPaddedBorderWidth 成員存在，此結構會比編譯 _WIN32_WINNT 小於或等於0x0502的應用程式大於 4 個字節。 如需條件式編譯的詳細資訊，請參閱使用 Windows 標頭。

Windows Server 2003 和 Windows XP/2000：如果針對 Windows Server 2008 或 Windows Vista 編譯的應用程式也必須在 Windows Server 2003 或 Windows XP/2000 上執行， 使用 GetVersionEx 函式在運行時間檢查操作系統版本，如果應用程式是在 Windows Server 2003 或 Windows XP/2000 上執行， 在呼叫 SystemParametersInfo 函式之前，從 cbSize 成員減去 iPaddedBorderWidth 成員的大小。

注意

winuser.h 標頭會將 NONCLIENTMETRICS 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winuser.h （包括 Windows.h）

另請參閱

LOGFONT

SystemParametersInfo