TextFormatFlags 列舉

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

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

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

public enum class TextFormatFlags

[System.Flags]
public enum TextFormatFlags

[<System.Flags>]
type TextFormatFlags = 

Public Enum TextFormatFlags

繼承

Object

ValueType

Enum

TextFormatFlags

屬性

FlagsAttribute

欄位

Bottom	8	靠周框 (Bounding Rectangle) 的底部對齊文字。 只有在文字為單行時才套用。
Default	0	套用預設格式，也就是靠左對齊。
EndEllipsis	32768	移除已修剪字行的結尾，並以省略符號取代。 當用來繪製文字時 TextRenderer，除非指定 旗標， ModifyString 否則不會修改字串。 將 PathEllipsis 和 WordEllipsis 相比較。
ExpandTabs	64	展開定位字元。 每個定位預設有八個字元。 WordEllipsis、PathEllipsis 和 EndEllipsis 等值不能配合 ExpandTabs 使用。
ExternalLeading	512	在行高中包含字型外部前置字元。 一般來說，外部前置字元並不包含在一行文字的高度之中。
GlyphOverhangPadding	0	加入邊框距離至周框中，以容納突出的圖像。 這是預設值。
HidePrefix	1048576	忽略文字中的 ampersand (&) 前置字元，使後面的字母不會加上底線，但仍會處理其他助記字元前置字元。
HorizontalCenter	1	讓文字在周框之內水平置中。
Internal	4096	使用系統字型，以計算文字度量資訊 (Metric)。
Left	0	讓文字靠裁剪區域 (Clipping Area) 的左邊對齊。 這是預設值。
LeftAndRightPadding	536870912	加入邊框距離至周框的兩邊。
ModifyString	65536	對繪製文字或文字量測不會有任何效果。 當用來繪製文字時 TextRenderer，如果顯示省略號，修改指定的字串參數以符合顯示的文字。 除非指定了 EndEllipsis 或 PathEllipsis，否則此值不會有任何效果。
NoClipping	256	允許顯示圖像的突出部分和超出格式化矩形以外的未換行文字。
NoFullWidthCharacterBreak	524288	沒有作用的舊版值。 它會防止雙倍寬字元字串出現分行符號，使分行規則相當於單倍寬字元字串的分行規則。
NoPadding	268435456	不要加入邊框距離至周框中。
NoPrefix	2048	關閉前置字元的處理作業。 一般而言，ampersand (&) 助記鍵前置詞字元會解譯為指示詞，以將後面字元加上底線，而雙 ampersand (&&) 助記字元做為指示詞，以列印單一 ampersand。 透過指定 NoPrefix，即可關閉此處理作業。 例如，套 NoPrefix 用的 “A&bc&&d” 輸入字串會導致 “A&bc&&d” 輸出。 與 PrefixOnly比較。
PathEllipsis	16384	移除已修剪字行的中央，並以省略符號取代。 當用來繪製文字時 TextRenderer，除非指定 旗標， ModifyString 否則不會修改字串。 將 EndEllipsis 和 WordEllipsis 相比較。
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	修剪字行至最接近的字，然後在已修剪的字行結尾放置省略符號。 將 EndEllipsis 和 PathEllipsis 相比較。

範例

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

另請參閱

• 使用字型和文字