格式化值

本節列出與 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	截斷任何不符合顯示矩形的字組，並新增省略號。