TextFormatFlags 列舉

定義

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

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

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags = 
Public Enum TextFormatFlags
繼承
TextFormatFlags
屬性

欄位

Bottom 8

靠周框 (Bounding Rectangle) 的底部對齊文字。 只有在文字為單行時才套用。

Default 0

套用預設格式,也就是靠左對齊。

EndEllipsis 32768

移除已修剪字行的結尾,並以省略符號取代。 當用來繪製文字時 TextRenderer,除非指定 旗標, ModifyString 否則不會修改字串。 將 PathEllipsisWordEllipsis 相比較。

ExpandTabs 64

展開定位字元。 每個定位預設有八個字元。 WordEllipsisPathEllipsisEndEllipsis 等值不能配合 ExpandTabs 使用。

ExternalLeading 512

在行高中包含字型外部前置字元。 一般來說,外部前置字元並不包含在一行文字的高度之中。

GlyphOverhangPadding 0

加入邊框距離至周框中,以容納突出的圖像。 這是預設值。

HidePrefix 1048576

忽略文字中的 ampersand (&) 前置字元,使後面的字母不會加上底線,但仍會處理其他助記字元前置字元。

HorizontalCenter 1

讓文字在周框之內水平置中。

Internal 4096

使用系統字型,以計算文字度量資訊 (Metric)。

Left 0

讓文字靠裁剪區域 (Clipping Area) 的左邊對齊。 這是預設值。

LeftAndRightPadding 536870912

加入邊框距離至周框的兩邊。

ModifyString 65536

對繪製文字或文字量測不會有任何效果。 當用來繪製文字時 TextRenderer,如果顯示省略號,修改指定的字串參數以符合顯示的文字。 除非指定了 EndEllipsisPathEllipsis,否則此值不會有任何效果。

NoClipping 256

允許顯示圖像的突出部分和超出格式化矩形以外的未換行文字。

NoFullWidthCharacterBreak 524288

沒有作用的舊版值。 它會防止雙倍寬字元字串出現分行符號,使分行規則相當於單倍寬字元字串的分行規則。

NoPadding 268435456

不要加入邊框距離至周框中。

NoPrefix 2048

關閉前置字元的處理作業。 一般而言,ampersand (&) 助記鍵前置詞字元會解譯為指示詞,以將後面字元加上底線,而雙 ampersand (&&) 助記字元做為指示詞,以列印單一 ampersand。 透過指定 NoPrefix,即可關閉此處理作業。 例如,套 NoPrefix 用的 “A&bc&&d” 輸入字串會導致 “A&bc&&d” 輸出。 與 PrefixOnly比較。

PathEllipsis 16384

移除已修剪字行的中央,並以省略符號取代。 當用來繪製文字時 TextRenderer,除非指定 旗標, ModifyString 否則不會修改字串。 將 EndEllipsisWordEllipsis 相比較。

PrefixOnly 2097152

在連字元 (& 之後的字元位置上只繪製底線,) 前置字元,而且不會在字串中繪製任何其他字元。

PreserveGraphicsClipping 16777216

保留由 Graphics 物件指定的裁剪。 僅套用於接到 IDeviceContext 的方法,也就是 Graphics

PreserveGraphicsTranslateTransform 33554432

保留由 Graphics 所指定的轉換。 僅套用於接到 IDeviceContext 的方法,也就是 Graphics

Right 2

讓文字靠裁剪區域的右邊對齊。

RightToLeft 131072

由右而左顯示文字。

SingleLine 32

以單行顯示文字。

TextBoxControl 8192

指定文字必須格式化,以供在 TextBox 控制項上顯示。

Top 0

靠周框的頂端對齊文字。 這是預設值。

VerticalCenter 4

讓文字在周框之內垂直置中。

WordBreak 16

在字的結尾讓文字分行。

WordEllipsis 262144

修剪字行至最接近的字,然後在已修剪的字行結尾放置省略符號。 將 EndEllipsisPathEllipsis 相比較。

範例

下列範例示範如何使用 TextFormatFlags 列舉。 若要執行此範例,請將下列程式代碼貼到 Windows Form 中。 從表單的Paint事件處理程式呼叫 RenderText6 ,傳遞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

適用於

另請參閱