静态控件样式

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

返回的常量	说明
SS_BITMAP	位图将显示在静态控件中。 文本是位图的名称， (不是资源文件中其他位置) 定义的文件名。 样式忽略 nWidth 和 nHeight 参数;控件自动调整自身大小以适应位图。
SS_BLACKFRAME	一个框，该框以与窗口框架相同的颜色绘制。 此颜色在默认配色方案中为黑色。
SS_BLACKRECT	用当前窗口框架颜色填充的矩形。 此颜色在默认配色方案中为黑色。
SS_CENTER	一个简单的矩形，使文本在矩形中居中。 在显示文本之前先设置其格式。 超出行尾的字词将自动包装到下一个居中线的开头。 长于控件宽度的单词将被截断。
SS_CENTERIMAGE	位图在包含它的静态控件中居中。 控件不会调整大小，因此将剪裁对控件来说太大的位图。 如果静态控件包含单行文本，则该文本将在控件的工作区中垂直居中。
SS_EDITCONTROL	静态控件复制多行编辑控件的文本显示特征。 具体而言，平均字符宽度的计算方式与使用编辑控件的方式相同，并且函数不显示部分可见的最后一行。
SS_ENDELLIPSIS	如果字符串的末尾不适合矩形，则会将其截断并添加省略号。 如果不在字符串末尾的单词超出矩形的限制，则会将其截断，而不用省略号。 使用此样式将强制控件文本位于一行中，不换行。 与 SS_PATHELLIPSIS 和 SS_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 或相关函数创建的，则文本是图标的名称 (而不是在与 createWindow 的 hInstance 参数指定的模块关联的资源文件中定义的) 文件名。 图标可以是动画光标。 样式忽略 CreateWindow 参数 nWidth 和 nHeight;控件会自动调整自身大小以适应图标。 由于它使用 LoadIcon 函数， SS_ICON 样式只能加载 维度SM_CXICON 和 SM_CYICON的图标。 除了SS_ICON以外，还可以使用 SS_REALSIZEIMAGE 样式来绕过 此限制。 如果无法通过 LoadIcon 加载图标，则会尝试使用 LoadCursor 将指定资源加载为游标。 如果也失败，则尝试使用 LoadImage 从设备驱动程序加载。
SS_LEFT	一个简单矩形，该矩形中的文本左对齐。 在显示文本之前先设置其格式。 超出行尾的字词将自动包装到下一个左对齐行的开头。 长于控件宽度的单词将被截断。
SS_LEFTNOWORDWRAP	一个简单矩形，该矩形中的文本左对齐。 选项卡已展开，但字词未换行。 超出行尾的文本将被剪裁。
SS_NOPREFIX	防止将控件文本中任何和 (&) 字符解释为快捷键前缀字符。 显示这些字符时，删除了与号，字符串中的下一个字符带有下划线。 此静态控件样式可以包含在任何定义的静态控件中。 可以将 SS_NOPREFIX 与其他样式组合使用。 当文件名或可能包含和 & () 的其他字符串必须显示在对话框中的静态控件中时，这可能很有用。
SS_NOTIFY	当用户 单击或双击控件时，发送父窗口STN_CLICKED、 STN_DBLCLK、 STN_DISABLE和 STN_ENABLE 通知代码。
SS_OWNERDRAW	静态控件的所有者负责绘制控件。 每当需要绘制控件时，所有者窗口都会收到 WM_DRAWITEM 消息。
SS_PATHELLIPSIS	将字符串中间的字符替换为省略号，以便结果适合指定的矩形。 如果字符串包含反斜杠 (\) 个字符， SS_PATHELLIPSIS 在最后一个反斜杠之后保留尽可能多的文本。 使用此样式将强制控件文本位于一行中，不换行。 与 SS_ENDELLIPSIS 和 SS_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 参数 nWidth 和 nHeight 指定的。 与 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_WORDBREAK标志和DT_ENDELLIPSIS设置的所有者绘图控件上使用 DrawThemeText 或 DrawText。

要求

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