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) |