静态控件样式

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

恒定 DESCRIPTION
SS_BITMAP
位图将显示在静态控件中。 文本是资源文件中其他地方定义的位图(而不是文件名)的名称。 样式忽略 nWidthnHeight 参数;控件会自动调整自身大小以适应位图。
SS_BLACKFRAME
一个框,以与窗口框架相同的颜色绘制框架。 此颜色在默认配色方案中为黑色。
SS_BLACKRECT
用当前窗口框架颜色填充的矩形。 此颜色在默认配色方案中为黑色。
SS_CENTER
一个简单的矩形,并将文本居中为中心。 文本在显示之前进行格式设置。 沿行末尾延伸的单词会自动包装到下一个居中线的开头。 超过控件宽度的单词将被截断。
SS_CENTERIMAGE
位图居中位于包含它的静态控件中。 控件的大小不会调整,因此将剪裁控件的位图太大。 如果静态控件包含单个文本行,则文本在控件的工作区中垂直居中。
SS_EDITCONTROL
静态控件复制多行编辑控件的文本显示特征。 具体而言,平均字符宽度的计算方式与编辑控件相同,并且函数不显示部分可见的最后一行。
SS_ENDELLIPSIS
如果字符串的末尾不适合矩形,则会截断并添加省略号。 如果字符串末尾的单词超出矩形的限制,则会在不省略号的情况下被截断。 使用此样式将强制控件的文本位于一行中,且不换行。 与 SS_PATHELLIPSISSS_WORDELLIPSIS进行比较。
SS_ENHMETAFILE
增强型图元文件将显示在静态控件中。 文本是图元文件的名称。 增强型图元文件静态控件的大小固定;将缩放图元文件以适应静态控件的工作区。
SS_ETCHEDFRAME
使用 EDGE_ETCHED 边缘样式绘制静态控件的框架。 有关详细信息,请参阅 DrawEdge 函数。
SS_ETCHEDHORZ
使用 EDGE_ETCHED 边缘样式绘制静态控件的上边缘和下边缘。 有关详细信息,请参阅 DrawEdge 函数。
SS_ETCHEDVERT
使用 EDGE_ETCHED 边缘样式绘制静态控件的左右边缘。 有关详细信息,请参阅 DrawEdge 函数。
SS_GRAYFRAME
具有与屏幕背景(桌面)相同的颜色绘制的框架的框。 此颜色在默认配色方案中为灰色。
SS_GRAYRECT
一个用当前屏幕背景色填充的矩形。 此颜色在默认配色方案中为灰色。
SS_ICON
要显示在对话框中的图标。 如果控件作为对话框的一部分创建,则文本是资源文件中其他地方定义的图标(而不是文件名)的名称。 如果控件是通过 CreateWindow 或相关函数创建的,则文本是与 hInstance 参数为 CreateWindow 参数指定的模块关联的资源文件中定义的图标(而不是文件名)的名称。
图标可以是动画光标。
样式忽略 CreateWindow 参数 nWidthnHeight;控件会自动调整大小以适应图标。 由于它使用 LoadIcon 函数, SS_ICON 样式只能加载 维度SM_CXICONSM_CYICON的图标。 除了SS_ICON之外,还可以使用SS_REALSIZEIMAGE样式绕过此限制。
如果无法通过 LoadIcon 加载图标,则尝试使用 LoadCursor 将指定资源加载为游标。 如果这也失败,则会尝试使用 LoadImage 从设备驱动程序加载。
SS_LEFT
一个简单的矩形,并将矩形中的文本左对齐。 文本在显示之前进行格式设置。 沿行末尾延伸的单词会自动包装到下一个左对齐行的开头。 超过控件宽度的单词将被截断。
SS_LEFTNOWORDWRAP
一个简单的矩形,并将矩形中的文本左对齐。 选项卡已展开,但单词未包装。 将剪裁超出行尾的文本。
SS_NOPREFIX
防止将控件文本中的任何与字符(>)字符解释为快捷键前缀字符。 这些字符串以删除和下划线显示,字符串中的下一个字符带下划线。 此静态控件样式可以包含在任何定义的静态控件中。 可以将 SS_NOPREFIX 与其他样式组合在一起。 当文件名或其他可能包含和号 (> 的字符串)必须显示在对话框中的静态控件中时,这非常有用。
SS_NOTIFY
当用户单击或双击控件时,发送父窗口 STN_CLICKEDSTN_DBLCLKSTN_DISABLESTN_ENABLE 通知代码。
SS_OWNERDRAW
静态控件的所有者负责绘制控件。 每当需要绘制控件时,所有者窗口都会收到 WM_DRAWITEM 消息。
SS_PATHELLIPSIS
将字符串中间的字符替换为省略号,以便结果适合指定的矩形。 如果字符串包含反斜杠(\)字符, 则SS_PATHELLIPSIS 在最后一个反斜杠后保留尽可能多的文本。 使用此样式将强制控件的文本位于一行中,且不换行。 与 SS_ENDELLIPSISSS_WORDELLIPSIS进行比较。
SS_REALSIZECONTROL
调整位图以适应静态控件的大小。 例如,更改区域设置可以更改系统字体,因此可能会调整控件的大小。 如果静态控件具有位图,则位图将不再适合该控件。 此样式位决定了位图的自动重新定义以适应其控件。
如果指定 了SS_CENTERIMAGE ,则位图或图标居中(如果需要剪裁)。 如果未指定 SS_CENTERIMAGE ,则位图或图标会拉伸或收缩。
请注意,两个轴中的重新定义是独立的,结果可能具有更改纵横比。
SS_REALSIZEIMAGE进行比较。
SS_REALSIZEIMAGE
指定使用实际资源宽度并使用 LoadImage 加载图标。 SS_REALSIZEIMAGE 始终与 SS_ICON一起使用。
SS_REALSIZEIMAGE 使用 LoadImage,重写通常在 SS_ICON 下遵循的过程。 它不加载游标;如果 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_ENDELLIPSISSS_PATHELLIPSIS进行比较。

注解

若要使用用多行文本省略号截断字词或字符串的样式,可以在所有者绘图控件上使用 DrawThemeTextDrawText ,并设置格式标志 DT_WORDBREAKDT_ENDELLIPSIS 集。

要求

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