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 映射桌面體驗中的可重設大小和不可重設大小的窗口結合。 若要編譯使用此成員的應用程式，請將 _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 上執行，請從 NONCLIENTMETRICS 結構的 cbSize 成員中減去 iPaddedBorderWidth 成員的大小，然後再呼叫 SystemParametersInfo 函式。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winuser.h (包括 Windows.h)

另請參閱

LOGFONT

SystemParametersInfo