共用方式為


格式化值

本節列出與 DrawThemeText 和 GetThemeTextExtent 函式之 dwTextFlags 參數搭配使用的值。 其中一或多個值可用來指定文字字串的格式。 DrawThemeText 函式會在 pRect 參數指定的顯示矩形內繪製文字字串。 GetThemeTextExtent 函式可用來判斷指定長度和格式文字的必要周框。

格式化值

下表列出格式值。

Description
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”
normal: “Ab&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”
normal: “Ab&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 截斷任何不符合顯示矩形的字組,並新增省略號。