TextFormatFlags 列挙型

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

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

C#

[System.Flags]
public enum TextFormatFlags

継承

Object

ValueType

Enum

TextFormatFlags

属性

FlagsAttribute

フィールド

名前	値	説明
Bottom	8	外接する四角形の下部に揃えてテキストを配置します。 テキストが 1 行の場合にだけ適用されます。
Default	0	既定の書式 (左寄せ) を適用します。
EndEllipsis	32768	トリムされる行の末尾を削除し、省略記号に置き換えます。 によって TextRendererテキストを描画するために使用する場合、 フラグが指定されていない限り、 ModifyString 文字列は変更されません。 PathEllipsis および WordEllipsis と比較します。
ExpandTabs	64	タブ文字を拡張します。 タブごとの既定の文字数は 8 文字です。 WordEllipsis、PathEllipsis、および 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。

C#

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);
}

注釈

列挙体 TextFormatFlags は、テキストの描画と測定時に TextRenderer によって使用されます。 ExpandTabs フラグを使用して既存のタブ ストップを拡張することはできますが、TextRenderer は、描画されたテキストへのタブ ストップの追加をサポートしていません。

適用対象

こちらもご覧ください

• フォントとテキストの使用