StringFormatFlags 列挙型

定義

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

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

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

フィールド

DirectionRightToLeft 1

テキストを右から左へ表示します。

DirectionVertical 2

テキストを縦方向に位置合わせします。

DisplayFormatControl 32

左から右を指示するマークなどの制御文字をグリフで表現します。

FitBlackBox 4

文字の一部が文字列のレイアウト四角形からはみ出すことを許可します。 既定では、はみ出さないように文字が移動されます。

LineLimit 8192

書式指定用の四角形には、完全な直線だけがレイアウトされます。 既定では、クリッピングの結果、テキストの末尾が表示された状態、または行が表示されなくなった状態のうち、いずれか早い方の状態になるまでレイアウトが継続します。 既定の設定では、行高さの整数倍でない書式指定用四角形を用いた場合は、最後の行の一部が隠れることがあります。 必ず行全体が表示されるようにするには、この値を指定した上で、少なくとも 1 つの行と高さが同じの書式指定用の四角形を使用してください。

MeasureTrailingSpaces 2048

各行の行末に空白を含めます。 既定では、MeasureString メソッドから返される外接四角形によって、各行末の空白が除外されます。 各行末の空白を計測に含める場合はこのフラグを設定します。

NoClip 16384

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

NoFontFallback 1024

要求されたフォントでサポートされていない文字のフォントを切り替えるフォールバックを無効にします。 欠落文字は、グリフの欠落したフォント (通常は空白の正方形) で表示されます。

NoWrap 4096

四角形内の書式を指定するときに、行のテキストの折り返しを無効にします。 このフラグは、四角形ではなく点が渡された場合、または長さゼロの行の四角形が指定された場合に暗黙的に指定されます。

次のコード例は、次のメンバーを示しています。

この例は、Windows フォームで使用するように設計されています。 フォームにコードを貼り付け、 として渡してePaintEventArgsフォームのPaintイベントを処理するときに メソッドを呼び出ShowLineAndAlignmentします。

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

注釈

StringFormatFlagsStringFormat クラスによって使用されます。

注意

FitBlackBox フィールドの名前が間違っており、その動作は元の NoFitBlackBox GDI+ 実装のフィールドに似ています。

適用対象