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