TextFormatFlags 列舉

定義

指定文字字串的顯示和配置資訊。

此列舉支援其成員值的位元組合。

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags = 
Public Enum TextFormatFlags
繼承
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」。 與 比較。PrefixOnly

Internal 4096

使用系統字型來計算文字指標。

TextBoxControl 8192

指定文字應格式化以便於 TextBox 控制項顯示。

PathEllipsis 16384

移除修剪線條的中心,並以省略號取代。 當用來繪製文字 TextRenderer時,除非 ModifyString 標示旗標,否則字串不會被修改。 比較 EndEllipsisWordEllipsis和 。

EndEllipsis 32768

移除裁切線條的末端,並以省略號取代。 當用來繪製文字 TextRenderer時,除非 ModifyString 標示旗標,否則字串不會被修改。 比較 PathEllipsisWordEllipsis和 。

ModifyString 65536

不影響繪製的文字或文字尺寸。 當用來繪製文字時 TextRenderer,會修改指定的字串參數,使其與顯示的文字相符(若顯示省略號)。 除非 EndEllipsis 有明確規定, PathEllipsis 否則此數值不具影響。

RightToLeft 131072

文字從右到左顯示。

WordEllipsis 262144

將行修剪至最近的字,並在修剪後的行末加上省略號。 比較 EndEllipsisPathEllipsis和 。

NoFullWidthCharacterBreak 524288

一個沒有影響的傳承價值。 它防止雙寬字串出現換行,因此換行規則等同於單寬字串。

HidePrefix 1048576

忽略文本中的&符號(&)前綴,使後續字母不會被底線,但其他助記前綴字元仍會被處理。

PrefixOnly 2097152

只在字母位置畫下底線,且不畫字串中其他字元。

PreserveGraphicsClipping 16777216

保留物件 Graphics 指定的裁剪。 僅適用於接收 且 IDeviceContextGraphics的方法。

PreserveGraphicsTranslateTransform 33554432

保留由 Graphics所指定的轉換。 僅適用於接收 且 IDeviceContextGraphics的方法。

NoPadding 268435456

不會為包圍矩形增加填充。

LeftAndRightPadding 536870912

為包圍矩形的兩側增加填充。

範例

以下範例示範如何使用列舉。TextFormatFlags 要執行此範例,請將以下程式碼貼上到 Windows 表單中。 從表單的事件處理程序RenderText6呼叫Paint,通過ePaintEventArgs

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 旗標展開現有的制表符。

適用於

另請參閱