TextFormatFlags 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指定文字字串的顯示和配置資訊。
此列舉支援其成員值的位元組合。
public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags =
Public Enum TextFormatFlags
- 繼承
- 屬性
欄位
| 名稱 | 值 | Description |
|---|---|---|
| Default | 0 | 套用預設格式,即左對齊。 |
| GlyphOverhangPadding | 0 | 在邊界矩形上增加填充,以容納懸垂的符文。 此為預設值。 |
| Left | 0 | 將文字對齊在裁切區域的左側。 此為預設值。 |
| Top | 0 | 將文字對齊到邊界矩形的頂端。 此為預設值。 |
| HorizontalCenter | 1 | 將文字水平置中於邊界矩形內。 |
| Right | 2 | 將文字對齊在裁切區域的右側。 |
| VerticalCenter | 4 | 將文字置中,置中於包圍矩形內。 |
| Bottom | 8 | 將文字對齊到包圍矩形底部。 僅在文字為單行時套用。 |
| WordBreak | 16 | 在單字結尾時斷開文字。 |
| SingleLine | 32 | 以一行方式顯示文字。 |
| ExpandTabs | 64 | 擴充制表字元。 預設每個分頁的字元數是八個。 WordEllipsis PathEllipsis, , 和 EndEllipsis 值無法用於 ExpandTabs。 |
| NoClipping | 256 | 讓字形的懸垂部分和伸出格式矩形的未展開文字顯示出來。 |
| ExternalLeading | 512 | 包含字體外部導字的行高。 通常,外部導言不會包含在一行文字的高度中。 |
| NoPrefix | 2048 | 關閉前綴字元的處理。 通常,& (&) 助記前綴被解釋為強調後續字元的指令,而雙 & (&&) 助記前綴則是列印單一 & 的指令。 指定 NoPrefix後,此處理會被關閉。 例如,輸入字串「A&bc&&d」且 NoPrefix applied 了,輸出會是「A&bc&&d」。 與 比較。 |
| Internal | 4096 | 使用系統字型來計算文字指標。 |
| TextBoxControl | 8192 | 指定文字應格式化以便於 TextBox 控制項顯示。 |
| PathEllipsis | 16384 | 移除修剪線條的中心,並以省略號取代。 當用來繪製文字 |
| EndEllipsis | 32768 | 移除裁切線條的末端,並以省略號取代。 當用來繪製文字 |
| ModifyString | 65536 | 不影響繪製的文字或文字尺寸。 當用來繪製文字時 |
| RightToLeft | 131072 | 文字從右到左顯示。 |
| WordEllipsis | 262144 | 將行修剪至最近的字,並在修剪後的行末加上省略號。 比較 EndEllipsisPathEllipsis和 。 |
| NoFullWidthCharacterBreak | 524288 | 一個沒有影響的傳承價值。 它防止雙寬字串出現換行,因此換行規則等同於單寬字串。 |
| HidePrefix | 1048576 | 忽略文本中的&符號(&)前綴,使後續字母不會被底線,但其他助記前綴字元仍會被處理。 |
| PrefixOnly | 2097152 | 只在字母位置畫下底線,且不畫字串中其他字元。 |
| PreserveGraphicsClipping | 16777216 | 保留物件 Graphics 指定的裁剪。 僅適用於接收 且 IDeviceContext 為 Graphics的方法。 |
| PreserveGraphicsTranslateTransform | 33554432 | 保留由 Graphics所指定的轉換。 僅適用於接收 且 IDeviceContext 為 Graphics的方法。 |
| NoPadding | 268435456 | 不會為包圍矩形增加填充。 |
| LeftAndRightPadding | 536870912 | 為包圍矩形的兩側增加填充。 |
範例
以下範例示範如何使用列舉。TextFormatFlags 要執行此範例,請將以下程式碼貼上到 Windows 表單中。 從表單的事件處理程序RenderText6呼叫Paint,通過e為 PaintEventArgs。
private void RenderText6(PaintEventArgs e)
{
TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
TextFormatFlags.EndEllipsis
TextRenderer.DrawText(e.Graphics, _
"This is some text that will be clipped at the end.", _
Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)
End Sub
備註
TextFormatFlags列舉在繪製和測量文字時會使用TextRenderer。 它 TextRenderer 不支援在繪製的文字中新增制表符,但你可以用這個 ExpandTabs 旗標展開現有的制表符。