Share via

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 成员，则此结构比使用小于或等于0x0502_WIN32_WINNT编译的应用程序大 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