设置值格式

本节列出了与 DrawThemeText 和 GetThemeTextExtent 函数的 dwTextFlags 参数一起使用的值。 其中一个或多个值用于指定文本字符串的格式。 DrawThemeText 函数将在 pRect 参数指定的显示矩形内绘制文本字符串。 GetThemeTextExtent 函数可用于确定给定长度和格式的文本所需的边界矩形。

设置值格式

下表列出了格式值。

值	说明
DT_BOTTOM	呈现显示矩形底部的文本字符串。 该值仅与 DT_SINGLELINE 值一起使用。
DT_CALCRECT	确定显示矩形的宽度和高度。
DT_CENTER	将文本在显示矩形内水平居中。
DT_EDITCONTROL	复制多行编辑控件的文本显示特性。 具体来说，平均字符宽度的计算方法与编辑控件相同，而且该函数不会显示部分可见的最后一行。
DT_END_ELLIPSIS	截断宽度大于显示矩形的文本字符串，并添加省略号来表示截断。 除非指定 DT_MODIFYSTRING 标志，否则字符串不会被修改。
DT_EXPANDTABS	展开制表符字符。 每个制表符的默认字符数为 8。 DT_WORD_ELLIPSIS、DT_PATH_ELLIPSIS 和 DT_END_ELLIPSIS 值不能与 DT_EXPANDTABS 值一起使用。
DT_EXTERNALLEADING	在行高中包含字体的外部前导。 通常情况下，外部前导会不包括在一行文字的高度内。
DT_HIDEPREFIX	忽略文本中的前缀字符 &。 后面的字母不加下划线，但仍会处理其他前缀字符。 例如： 输入字符串：“A&bc&&d” 正常：“Abc&d” DT_HIDEPREFIX：“Abc&d”
DT_LEFT	让文本左对齐。
DT_MODIFYSTRING	修改字符串以匹配显示的文本。 除非指定 DT_END_ELLIPSIS 或 DT_PATH_ELLIPSIS，否则此值不起作用。
DT_NOCLIP	在不裁剪显示矩形的情况下绘制文本字符串。
DT_NOFULLWIDTHCHARBREAK	防止在双字节字符集 (DBCS) 上换行，这样换行规则就等效于单字节字符集 (SBCS)。 例如，这可以用来让以韩文书写的图标标签更加易于阅读。 除非指定 DT_WORDBREAK，否则此值无效。
DT_NOPREFIX	关闭对前缀字符的处理。 通常，DrawThemeText 会将前缀字符 & 解释为对后面的字符下划线的指令，将前缀字符 && 解释为打印单个 & 的指令。 通过指定 DT_NOPREFIX，此处理将被关闭。 例如： 输入字符串：“A&bc&&d” 正常：“Abc&d” DT_NOPREFIX：“A&bc&&d”
DT_PATH_ELLIPSIS	用省略号替换文本中间的字符，让结果适合显示矩形。 如果字符串包含反斜杠 (\) 字符，则 DT_PATH_ELLIPSIS 会尽可能保留最后一个反斜杠后面的文本。 除非指定 DT_MODIFYSTRING 标志，否则字符串不会被修改。
DT_PREFIXONLY	仅在前缀字符 & 之后的字符位置画下划线。 通常，DrawThemeText 会将 & 解释为下划线字符的指令，将前缀字符 && 解释为打印单个 & 的指令。 如果指定 DT_PREFIXONLY，则不会绘制任何字符，而只绘制下划线。 在字符通常出现的位置会保留空白。 例如： 输入字符串：“A&bc&&d” 正常：“Abc&d DT_PREFIXONLY：“ ”
DT_RIGHT	让文本右对齐。
DT_RTLREADING	对于双向文本，例如希伯来文或阿拉伯文字体的文本，将按从右到左的顺序排列。 文本的默认方向是从左到右。
DT_SINGLELINE	在单行上显示文本。 回车符和换行符不会断行。
DT_TABSTOP	设置制表符停止位置。
DT_TOP	呈现显示矩形顶部的文本。
DT_VCENTER	垂直居中文本。 该值仅与 DT_SINGLELINE 值一起使用。
DT_WORDBREAK	如果字词超出了显示矩形的边缘，则在字词之间换行。 回车符/换行符 (CR/LF) 序列也会断行。
DT_WORD_ELLIPSIS	截断不适合显示矩形的任何字词并添加省略号。