NONCLIENTMETRICSA 结构 （winuser.h）

包含与非分钟化窗口的非client 区域关联的可缩放指标。 此结构由 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 函数之前，从 NONCLIENTMETRICS 结构的 cbSize 成员中减去 iPaddedBorderWidth 成员的大小。

注意

winuser.h 标头将 NONCLIENTMETRICS 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
标头	winuser.h （包括 Windows.h）

另请参阅

LOGFONT

SystemParametersInfo