StringFormatFlags StringFormatFlags StringFormatFlags StringFormatFlags Enum

定義

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

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

public enum class StringFormatFlags
[System.Flags]
public enum StringFormatFlags
type StringFormatFlags = 
Public Enum StringFormatFlags
継承
StringFormatFlagsStringFormatFlagsStringFormatFlagsStringFormatFlags
属性

フィールド

DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft DirectionRightToLeft 1

テキストを右から左へ表示します。Text is displayed from right to left.

DirectionVertical DirectionVertical DirectionVertical DirectionVertical 2

テキストを縦方向に位置合わせします。Text is vertically aligned.

DisplayFormatControl DisplayFormatControl DisplayFormatControl DisplayFormatControl 32

左から右を指示するマークなどの制御文字をグリフで表現します。Control characters such as the left-to-right mark are shown in the output with a representative glyph.

FitBlackBox FitBlackBox FitBlackBox FitBlackBox 4

文字の一部が文字列のレイアウト四角形からはみ出すことを許可します。Parts of characters are allowed to overhang the string's layout rectangle. 既定では、はみ出さないように文字が移動されます。By default, characters are repositioned to avoid any overhang.

LineLimit LineLimit LineLimit LineLimit 8192

書式指定用の四角形には、完全な直線だけがレイアウトされます。Only entire lines are laid out in the formatting rectangle. 既定では、クリッピングの結果、テキストの末尾が表示された状態、または行が表示されなくなった状態のうち、いずれか早い方の状態になるまでレイアウトが継続します。By default layout continues until the end of the text, or until no more lines are visible as a result of clipping, whichever comes first. 既定の設定では、行高さの整数倍でない書式指定用四角形を用いた場合は、最後の行の一部が隠れることがあります。Note that the default settings allow the last line to be partially obscured by a formatting rectangle that is not a whole multiple of the line height. 必ず行全体が表示されるようにするには、この値を指定した上で、少なくとも 1 つの行と高さが同じの書式指定用の四角形を使用してください。To ensure that only whole lines are seen, specify this value and be careful to provide a formatting rectangle at least as tall as the height of one line.

MeasureTrailingSpaces MeasureTrailingSpaces MeasureTrailingSpaces MeasureTrailingSpaces 2048

各行の行末に空白を含めます。Includes the trailing space at the end of each line. 既定では、MeasureString メソッドから返される外接四角形によって、各行末の空白が除外されます。By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. 各行末の空白を計測に含める場合はこのフラグを設定します。Set this flag to include that space in measurement.

NoClip NoClip NoClip NoClip 16384

グリフの突出部と書式指定用の四角形からはみ出すラップされていないテキストを表示できます。Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. 既定では、書式指定用の四角形からはみ出たテキストとグリフ部はすべてクリップされます。By default all text and glyph parts reaching outside the formatting rectangle are clipped.

NoFontFallback NoFontFallback NoFontFallback NoFontFallback 1024

要求されたフォントでサポートされていない文字のフォントを切り替えるフォールバックを無効にします。Fallback to alternate fonts for characters not supported in the requested font is disabled. 欠落文字は、グリフの欠落したフォント (通常は空白の正方形) で表示されます。Any missing characters are displayed with the fonts missing glyph, usually an open square.

NoWrap NoWrap NoWrap NoWrap 4096

四角形内の書式を指定するときに、行のテキストの折り返しを無効にします。Text wrapping between lines when formatting within a rectangle is disabled. このフラグは、四角形ではなく点が渡された場合、または長さゼロの行の四角形が指定された場合に暗黙的に指定されます。This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.

次のコード例では、次のメンバーを示しています。The following code example demonstrates the following members:

この例は、Windows フォームで使用する設計されています。This example is designed to be used with Windows Forms. フォームと呼び出しにコードを貼り付けます、ShowLineAndAlignmentメソッド、フォームを処理するときにPaint渡すイベントeとしてPaintEventArgsします。Paste the code into a form and call the ShowLineAndAlignment method when handling the form's Paint event, passing e as PaintEventArgs.

private:
   void ShowLineAndAlignment( PaintEventArgs^ e )
   {
      // Construct a new Rectangle .
      Rectangle displayRectangle = Rectangle(Point(40,40),System::Drawing::Size( 80, 80 ));
      
      // Construct 2 new StringFormat objects
      StringFormat^ format1 = gcnew StringFormat( StringFormatFlags::NoClip );
      StringFormat^ format2 = gcnew StringFormat( format1 );
      
      // Set the LineAlignment and Alignment properties for
      // both StringFormat objects to different values.
      format1->LineAlignment = StringAlignment::Near;
      format1->Alignment = StringAlignment::Center;
      format2->LineAlignment = StringAlignment::Center;
      format2->Alignment = StringAlignment::Far;
      
      // Draw the bounding rectangle and a string for each
      // StringFormat object.
      e->Graphics->DrawRectangle( Pens::Black, displayRectangle );
      e->Graphics->DrawString( "Showing Format1", this->Font, Brushes::Red, displayRectangle, format1 );
      e->Graphics->DrawString( "Showing Format2", this->Font, Brushes::Red, displayRectangle, format2 );
   }
private void ShowLineAndAlignment(PaintEventArgs e)
{

    // Construct a new Rectangle .
    Rectangle  displayRectangle = 
        new Rectangle (new Point(40, 40), new Size (80, 80));

    // Construct 2 new StringFormat objects
    StringFormat format1 = new StringFormat(StringFormatFlags.NoClip);
    StringFormat format2 = new StringFormat(format1);

    // Set the LineAlignment and Alignment properties for
    // both StringFormat objects to different values.
    format1.LineAlignment = StringAlignment.Near;
    format1.Alignment = StringAlignment.Center;
    format2.LineAlignment = StringAlignment.Center;
    format2.Alignment = StringAlignment.Far;

    // Draw the bounding rectangle and a string for each
    // StringFormat object.
    e.Graphics.DrawRectangle(Pens.Black, displayRectangle);
    e.Graphics.DrawString("Showing Format1", this.Font, 
        Brushes.Red, (RectangleF)displayRectangle, format1);
    e.Graphics.DrawString("Showing Format2", this.Font, 
        Brushes.Red, (RectangleF)displayRectangle, format2);
}
Private Sub ShowLineAndAlignment(ByVal e As PaintEventArgs)

    ' Construct a new Rectangle.
    Dim displayRectangle _
        As New Rectangle(New Point(40, 40), New Size(80, 80))

    ' Construct two new StringFormat objects
    Dim format1 As New StringFormat(StringFormatFlags.NoClip)
    Dim format2 As New StringFormat(format1)

    ' Set the LineAlignment and Alignment properties for
    ' both StringFormat objects to different values.
    format1.LineAlignment = StringAlignment.Near
    format1.Alignment = StringAlignment.Center
    format2.LineAlignment = StringAlignment.Center
    format2.Alignment = StringAlignment.Far

    ' Draw the bounding rectangle and a string for each
    ' StringFormat object.
    e.Graphics.DrawRectangle(Pens.Black, displayRectangle)
    e.Graphics.DrawString("Showing Format1", Me.Font, Brushes.Red, _
        RectangleF.op_Implicit(displayRectangle), format1)
    e.Graphics.DrawString("Showing Format2", Me.Font, Brushes.Red, _
        RectangleF.op_Implicit(displayRectangle), format2)
End Sub

注釈

StringFormatFlags 使って、StringFormatクラス。StringFormatFlags is used by the StringFormat class.

注意

FitBlackBox フィールドが誤った名前が付いてし、その動作に似ています、NoFitBlackBoxフィールドで元の GDI + の実装。The FitBlackBox field was misnamed and its behavior is similar to the NoFitBlackBox field in the original GDI+ implementation.

適用対象