TextFormatFlags 列挙型

定義

文字列の表示情報およびレイアウト情報を指定します。

この列挙体は、メンバー値のビットごとの組み合わせをサポートしています。

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

フィールド

Bottom 8

外接する四角形の下部に揃えてテキストを配置します。 テキストが 1 行の場合にだけ適用されます。

Default 0

既定の書式 (左寄せ) を適用します。

EndEllipsis 32768

トリムされる行の末尾を削除し、省略記号に置き換えます。 によって TextRendererテキストを描画するために使用する場合、 フラグが指定されていない限り、 ModifyString 文字列は変更されません。 PathEllipsis および WordEllipsis と比較します。

ExpandTabs 64

タブ文字を拡張します。 タブごとの既定の文字数は 8 文字です。 WordEllipsisPathEllipsis、および EndEllipsis の各値は、ExpandTabs では使用できません。

ExternalLeading 512

行の高さにフォントの外部レディングを含めます。 通常、外部レディングは、テキストの行の高さに含まれません。

GlyphOverhangPadding 0

グリフの突出部が収まるように、外接する四角形にパディングを追加します。 これは既定値です。

HidePrefix 1048576

テキスト内のアンパサンド (&) プレフィックス文字を無視して、後の文字に下線が引かないようにしますが、他のニーモニック プレフィックス文字は引き続き処理されます。

HorizontalCenter 1

外接する四角形内に、テキストを横方向に中央揃えで配置します。

Internal 4096

システム フォントを使用して、テキスト メトリックを計算します。

Left 0

テキストをクリッピング領域の左側に揃えて配置します。 これは既定値です。

LeftAndRightPadding 536870912

外接する四角形の両側にパディングを追加します。

ModifyString 65536

描画されたテキストまたはテキストの測定には影響しません。 で TextRendererテキストを描画するために使用すると、省略記号が表示されている場合に、表示されるテキストと一致するように指定された文字列パラメーターが変更されます。 この値は、EndEllipsis または PathEllipsis が指定されていない限り、影響しません。

NoClipping 256

グリフの突出部と書式指定用の四角形からはみ出すラップされていないテキストを表示できるようにします。

NoFullWidthCharacterBreak 524288

影響のない従来の値。 これにより 2 バイトの文字列での改行が防がれるため、改行ルールは 1 バイトの文字列のものと等しいです。

NoPadding 268435456

外接する四角形にパディングを追加しません。

NoPrefix 2048

先頭文字の処理を無効にします。 通常、アンパサンド (&) ニーモニック プレフィックス文字は、後の文字をアンダースコア付けするためのディレクティブとして解釈され、二重アンパサンド (&&) ニーモニック プレフィックス文字は、1 つのアンパサンドを出力するディレクティブとして解釈されます。 NoPrefix を指定すると、この処理が無効になります。 たとえば、"A&bc&&d" の入力文字列が NoPrefix 適用されると、"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

テキストを 1 行で表示します。

TextBoxControl 8192

テキストを TextBox コントロールに表示するために書式設定する必要があることを指定します。

Top 0

外接する四角形の上部に揃えてテキストを配置します。 これは既定値です。

VerticalCenter 4

外接する四角形内に、テキストを縦方向に中央揃えで配置します。

WordBreak 16

単語の末尾でテキストを改行します。

WordEllipsis 262144

行を最も近い単語までトリムします。トリムされた行の末尾には、省略記号が配置されます。 EndEllipsis および PathEllipsis と比較します。

次の例では、 列挙体を使用する方法を TextFormatFlags 示します。 この例を実行するには、次のコードを Windows フォームに貼り付けます。 フォームPaintのイベント ハンドラーから を呼び出RenderText6し、 を としてPaintEventArgs渡しますe

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 によって使用されます。 ExpandTabs フラグを使用して既存のタブ ストップを拡張することはできますが、TextRenderer は、描画されたテキストへのタブ ストップの追加をサポートしていません。

適用対象

こちらもご覧ください