TextFormatFlags 列挙型

定義

文字列の表示情報およびレイアウト情報を指定します。Specifies the display and layout information for text strings.

この列挙体には FlagsAttribute 属性があり、そのメンバー値のビットごとの組み合わせが可能になります。

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

フィールド

Bottom 8

外接する四角形の下部に揃えてテキストを配置します。Aligns the text on the bottom of the bounding rectangle. テキストが 1 行の場合にだけ適用されます。Applied only when the text is a single line.

Default 0

既定の書式 (左寄せ) を適用します。Applies the default formatting, which is left-aligned.

EndEllipsis 32768

トリムされる行の末尾を削除し、省略記号に置き換えます。Removes the end of trimmed lines, and replaces them with an ellipsis. TextRenderer でテキストを描画するために使用する場合、ModifyString フラグが指定されていない限り、文字列は変更されません。When used to draw text by TextRenderer, the string is not modified unless the ModifyString flag is specified. PathEllipsis および WordEllipsis と比較します。Compare with PathEllipsis and WordEllipsis.

ExpandTabs 64

タブ文字を拡張します。Expands tab characters. タブごとの既定の文字数は 8 文字です。The default number of characters per tab is eight. WordEllipsisPathEllipsis、および EndEllipsis の各値は、ExpandTabs では使用できません。The WordEllipsis, PathEllipsis, and EndEllipsis values cannot be used with ExpandTabs.

ExternalLeading 512

行の高さにフォントの外部レディングを含めます。Includes the font external leading in line height. 通常、外部レディングは、テキストの行の高さに含まれません。Typically, external leading is not included in the height of a line of text.

GlyphOverhangPadding 0

グリフの突出部が収まるように、外接する四角形にパディングを追加します。Adds padding to the bounding rectangle to accommodate overhanging glyphs. これは既定値です。This is the default.

HidePrefix 1048576

これによりテキストのアンパサンド (&) プレフィックス文字が無視されるため、後の文字に下線は引かれませんが、他のニーモニック プレフィックス文字は引き続き処理されます。Ignores the ampersand (&) prefix character in the text, so that the letter that follows won't be underlined, but other mnemonic-prefix characters are still processed.

HorizontalCenter 1

外接する四角形内に、テキストを横方向に中央揃えで配置します。Centers the text horizontally within the bounding rectangle.

Internal 4096

システム フォントを使用して、テキスト メトリックを計算します。Uses the system font to calculate text metrics.

Left 0

テキストをクリッピング領域の左側に揃えて配置します。Aligns the text on the left side of the clipping area. これは既定値です。This is the default.

LeftAndRightPadding 536870912

外接する四角形の両側にパディングを追加します。Adds padding to both sides of the bounding rectangle.

ModifyString 65536

描画されたテキストまたはテキストの測定には影響しません。Has no effect on the drawn text or text measurements. TextRenderer でテキストを描画するために使用する場合は、省略記号が表示されている場合に、表示されるテキストと一致するように、指定した文字列パラメーターを変更します。When used to draw text by TextRenderer, modifies the specified string parameter to match the displayed text if ellipsis are shown. この値は、EndEllipsis または PathEllipsis が指定されていない限り、影響しません。This value has no effect unless EndEllipsis or PathEllipsis is specified.

NoClipping 256

グリフの突出部と書式指定用の四角形からはみ出すラップされていないテキストを表示できるようにします。Allows the overhanging parts of glyphs and unwrapped text reaching outside the formatting rectangle to show.

NoFullWidthCharacterBreak 524288

影響のない従来の値。A legacy value that has no effect. これにより 2 バイトの文字列での改行が防がれるため、改行ルールは 1 バイトの文字列のものと等しいです。It prevents a line break at a double-wide character string, so that the line-breaking rule is equivalent to that for single-wide character strings.

NoPadding 268435456

外接する四角形にパディングを追加しません。Does not add padding to the bounding rectangle.

NoPrefix 2048

先頭文字の処理を無効にします。Turns off processing of prefix characters. 通常、ニーモニックのプレフィックス文字であるアンパサンド (&) は、これに続く文字に下線を引くディレクティブと解釈されます。また、ニーモニックのプレフィックス文字である二重アンパサンド (&&) は、単一のアンパサンドを印刷するディレクティブと解釈されます。Typically, the ampersand (&) mnemonic-prefix character is interpreted as a directive to underscore the character that follows, and the double-ampersand (&&) mnemonic-prefix characters as a directive to print a single ampersand. NoPrefix を指定すると、この処理が無効になります。By specifying NoPrefix, this processing is turned off. たとえば、"A&bc&&d" の入力文字列に NoPrefix が適用されると、"A&bc&&d" が出力されることになります。For example, an input string of "A&bc&&d" with NoPrefix applied would result in output of "A&bc&&d". PrefixOnly と比較します。Compare with PrefixOnly.

PathEllipsis 16384

トリムされる行の中央を削除し、省略記号に置き換えます。Removes the center of trimmed lines and replaces it with an ellipsis. TextRenderer でテキストを描画するために使用する場合、ModifyString フラグが指定されていない限り、文字列は変更されません。When used to draw text by TextRenderer, the string is not modified unless the ModifyString flag is specified. EndEllipsis および WordEllipsis と比較します。Compare with EndEllipsis and WordEllipsis.

PrefixOnly 2097152

アンパサンド (&) プレフィックス文字に続く文字の位置にのみ下線が描画され、文字列のその他の文字は描画されません。Draws only an underline at the position of the character following the ampersand (&) prefix character and doesn't draw any other characters in the string.

PreserveGraphicsClipping 16777216

Graphics オブジェクトで指定されたクリッピングを維持します。Preserves the clipping specified by a Graphics object. IDeviceContext である Graphics を受信するメソッドだけに適用されます。Applies only to methods receiving an IDeviceContext that is a Graphics.

PreserveGraphicsTranslateTransform 33554432

Graphics で指定された変換を維持します。Preserves the transformation specified by a Graphics. IDeviceContext である Graphics を受信するメソッドだけに適用されます。Applies only to methods receiving an IDeviceContext that is a Graphics.

Right 2

テキストをクリッピング領域の右側に揃えて配置します。Aligns the text on the right side of the clipping area.

RightToLeft 131072

テキストを右から左へ表示します。Displays the text from right to left.

SingleLine 32

テキストを 1 行で表示します。Displays the text in a single line.

TextBoxControl 8192

テキストを TextBox コントロールに表示するために書式設定する必要があることを指定します。Specifies the text should be formatted for display on a TextBox control.

Top 0

外接する四角形の上部に揃えてテキストを配置します。Aligns the text on the top of the bounding rectangle. これは既定値です。This is the default.

VerticalCenter 4

外接する四角形内に、テキストを縦方向に中央揃えで配置します。Centers the text vertically, within the bounding rectangle.

WordBreak 16

単語の末尾でテキストを改行します。Breaks the text at the end of a word.

WordEllipsis 262144

行を最も近い単語までトリムします。トリムされた行の末尾には、省略記号が配置されます。Trims the line to the nearest word and an ellipsis is placed at the end of a trimmed line. EndEllipsis および PathEllipsis と比較します。Compare with EndEllipsis and PathEllipsis.

次の例は、列挙型の使用方法を示して TextFormatFlags います。The following example demonstrates how to use the TextFormatFlags enumeration. この例を実行するには、Windows フォームに次のコードを貼り付けます。To run this example, paste the following code into a Windows Form. RenderText6フォームのイベントハンドラーからを呼び出し Paint て、 e としてを渡し PaintEventArgs ます。Call RenderText6 from the form's Paint event handler, passing e as 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 描画および測定するときにによって使用されます。The TextFormatFlags enumeration is used by the TextRenderer when drawing and measuring text. は、 TextRenderer 描画されたテキストへのタブストップの追加をサポートしていませんが、フラグを使用して既存のタブストップを展開することはでき ExpandTabs ます。The TextRenderer does not support adding tab stops to drawn text, although you can expand existing tab stops using the ExpandTabs flag.

適用対象