静态控件样式

若要使用 CreateWindowCreateWindowEx 函数创建静态控件,请指定静态类、适当的窗口样式常量以及以下静态控件样式的组合。

返回的常量 说明
SS _ 位图
位图将显示在静态控件中。 文本是位图的名称, (在资源文件中的其他位置定义) 文件名。 样式将忽略 nWidthnHeight 参数;控件自动调整自身大小以容纳位图。
SS _ BLACKFRAME
一个框,其框架以与窗口框架相同的颜色绘制。 此颜色在默认配色方案中为黑色。
SS _ BLACKRECT
用当前窗口框架颜色填充的矩形。 此颜色在默认配色方案中为黑色。
SS _ 中心
一个简单的矩形,并使文本在矩形中居中。 文本在显示前进行格式设置。 超出行末尾的单词会自动包装到下一个居中行的开头。 长度超过控件宽度的单词将被截断。
SS _ CENTERIMAGE
位图位于包含它的静态控件中。 控件没有调整大小,因此控件的位图过大就会被剪裁掉。 如果静态控件包含单行文本,则文本在控件的工作区中垂直居中。
SS _ EDITCONTROL
静态控件复制多行编辑控件的文本显示特性。 具体而言,平均字符宽度的计算方式与编辑控件相同,并且函数不显示部分可见的最后一行。
SS _ ENDELLIPSIS
如果在矩形中不能容纳字符串的末尾,则将其截断并添加省略号。 如果不在字符串末尾的单词超出了矩形的限制,则将其截断而不包含省略号。 使用此样式将强制控件的文本在不换行的一行上。 与 ss _ PATHELLIPSISss _ WORDELLIPSIS 进行比较。
SS _ ENHMETAFILE
增强型图元文件将显示在静态控件中。 文本是图元文件的名称。 增强型图元文件静态控件具有固定大小;图元文件经过缩放以适合静态控件的工作区。
SS _ ETCHEDFRAME
使用 边缘 _ 蚀刻 边缘样式绘制静态控件的帧。 有关详细信息,请参阅 DrawEdge 函数。
SS _ ETCHEDHORZ
使用 边缘 _ 蚀刻 边缘样式绘制静态控件的上边缘和下边缘。 有关详细信息,请参阅 DrawEdge 函数。
SS _ ETCHEDVERT
使用 边缘 _ 蚀刻 边缘样式绘制静态控件的左边缘和右边缘。 有关详细信息,请参阅 DrawEdge 函数。
SS _ GRAYFRAME
带有用与屏幕背景相同的颜色绘制的框 (桌面) 。 此颜色在默认配色方案中为灰色。
SS _ GRAYRECT
用当前屏幕背景色填充的矩形。 此颜色在默认配色方案中为灰色。
SS _ 图标
要在对话框中显示的图标。 如果控件是作为对话框的一部分创建的,则该文本是图标的名称, (不是文件名) 在资源文件中的其他位置进行定义。 如果该控件是通过 CreateWindow或相关函数创建的,则该文本是与 hInstance 参数所指定的模块关联的资源文件中定义的 (图标的名称 ) 。
图标可以是动画光标。
样式忽略 CreateWindow 参数 nWidthnHeight;控件自动调整自身大小以容纳图标。 由于它使用 LoadIcon 函数,因此 SS _ 图标 样式只能加载维度 SM _ CXICONSM _ CYICON 的图标。 除了 ss _ 图标 外,还可以使用 ss _ REALSIZEIMAGE 样式绕过此限制。
如果无法通过 LoadIcon加载图标,则会尝试使用 LoadCursor将指定的资源加载为游标。 如果此操作失败,则尝试使用 LoadImage从设备驱动程序加载。
_左 SS
一个简单的矩形,并使文本在矩形中左对齐。 文本在显示前进行格式设置。 超出行末尾的单词会自动换行到下一条左对齐行的开头。 长度超过控件宽度的单词将被截断。
SS _ LEFTNOWORDWRAP
一个简单的矩形,并使文本在矩形中左对齐。 选项卡将展开,但不会换行。 延伸超出行尾的文本将被剪裁掉。
SS _ NOPREFIX
防止解释控件文本中的任何 "与" 符号 (&) 字符作为快捷键前缀字符。 其中显示了 "与" 符号,并以下划线显示字符串中的下一个字符。 此静态控件样式可能包含在任何定义的静态控件中。 可以将 SS _ NOPREFIX 与其他样式组合。 当必须在对话框中的静态控件中显示文件名或其他可能包含 "and") (& 符的字符串时,这会很有用。
SS _ 通知
当用户单击或双击控件时,将发送 STN _ 单击STN _ DBLCLKSTN _ DISABLESTN _ 启用 通知代码的父窗口。
SS _ OWNERDRAW
静态控件的所有者负责绘制控件。 每当需要绘制控件时,所有者窗口都会收到一条 WM _ DRAWITEM 消息。
SS _ PATHELLIPSIS
将字符串中间的字符替换为省略号,使结果适合指定的矩形。 如果字符串包含反斜杠 (\) 字符,则 SS _ PATHELLIPSIS 将尽可能地保留最后一个反斜杠后面的文本。 使用此样式将强制控件的文本在不换行的一行上。 与 ss _ ENDELLIPSISss _ WORDELLIPSIS 进行比较。
SS _ REALSIZECONTROL
调整位图以适合静态控件的大小。 例如,更改区域设置可以更改系统字体,因此控件可能会调整大小。 如果静态控件有位图,则位图将不再适合控件。 此样式位指示自动 redimensioning 位图以适合其控件。
如果指定 SS _ CENTERIMAGE ,则位图或图标将居中 (并在需要时剪辑) 。 如果未指定 SS _ CENTERIMAGE ,则会拉伸或收缩位图或图标。
请注意,两个轴中的 redimensioning 是独立的,并且结果可能具有更改的纵横比。
SS _ REALSIZEIMAGE 比较。
SS _ REALSIZEIMAGE
指定使用实际资源宽度,并使用 LoadImage加载该图标。 SS _REALSIZEIMAGE 始终与 SS _ 图标 一起使用。
SS _REALSIZEIMAGE 使用 LoadImage,重写该进程,但后面跟在 SS _ 图标 下。 它不会加载游标;如果 LoadImage 失败,则不进一步尝试加载。 它使用实际资源宽度。 静态控件会相应地调整大小,但图标仍与最初指定的控件左边缘和上边缘对齐。
请注意,如果 还指定了 SS _ CENTERIMAGE, 则图标在控件的空间内居中,该空间是使用 CreateWindow 参数 nWidthnHeight 指定的
SS _ REALSIZECONTROL 进行比较
SS _ RIGHT
一个简单的矩形,并右对齐矩形中的文本。 文本在显示之前已设置格式。 超出行尾的字词会自动换行到下一个右对齐行的开头。 超过控件宽度的字词将被截断。
SS _ RIGHTJUST
调整控件大小时,具有 SS BITMAP 或 SS ICON 样式的静态控件的右下角保持 _ _ 固定。 仅调整顶部和左侧以适应新的位图或图标。
SS _ SIMPLE
一个简单的矩形,在矩形中显示一行左对齐文本。 不能以任何方式缩短或更改文本行。 此外,如果控件处于禁用状态,则控件不会灰显其文本。
SS _ SUNKEN
在静态控件周围绘制一个半凹下边框。
SS _ TYPEMASK
在 SS 样式位上使用 OR 运算符后的结果复合 _ * 样式位。 可用于屏蔽给定位掩码中的有效 SS _ * 位。 请注意,这已过时,未正确包含所有有效样式。 因此,不应使用此样式。
SS _ WHITEFRAME
一个框,其框架绘制的颜色与窗口背景的颜色相同。 此颜色在默认配色方案中为白色。
SS _ WHITERECT
用当前窗口背景色填充的矩形。 此颜色在默认配色方案中为白色。
SS _ WORDELLIPSIS
截断矩形中不适合的任何单词并添加省略号。 使用此样式将强制控件的文本位于没有自动换行的一行上。
SS _ ENDELLIPSIS 和 SS _ PATHELLIPSIS 进行比较

备注

若要使用带省略号的样式截断多行文本的单词或字符串,可在设置了格式标志 DT _ WORDBREAKDT _ ENDELLIPSIS 的所有者绘图控件上使用 DrawThemeTextDrawText。

要求

要求
最低受支持的客户端
Windows仅 [ Vista 桌面应用]
最低受支持的服务器
Windows仅服务器 2003 [ 桌面应用]
标头
Winuser.h (包括 Windows.h)