StringFormat.SetTabStops メソッド

.NET Framework クラス ライブラリ リファレンス

StringFormat.SetTabStops メソッド

この StringFormat オブジェクトのタブ ストップを設定します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub SetTabStops ( _
    firstTabOffset As Single, _
    tabStops As Single() _
)

Visual Basic (使用法)

Dim instance As StringFormat
Dim firstTabOffset As Single
Dim tabStops As Single()

instance.SetTabStops(firstTabOffset, tabStops)

C#

public void SetTabStops (
    float firstTabOffset,
    float[] tabStops
)

C++

public:
void SetTabStops (
    float firstTabOffset, 
    array<float>^ tabStops
)

J#

public void SetTabStops (
    float firstTabOffset, 
    float[] tabStops
)

JScript

public function SetTabStops (
    firstTabOffset : float, 
    tabStops : float[]
)

パラメータ

firstTabOffset

テキスト行の先頭と最初のタブ ストップ間の空白の数。

tabStops

タブ ストップの間隔の配列。単位は、Graphics.PageUnit プロパティによって指定します。

解説

tabStops 配列における各タブ ストップのオフセットは、最初のタブ ストップを除いて、直前のタブ ストップが基準です。最初のタブ ストップのオフセットは、firstTabOffset によって指定される初期オフセット位置が基準です。たとえば、初期オフセット位置が 8 で、最初のタブ ストップのオフセットが 50 の場合、最初のタブ ストップの位置は 58 になります。初期オフセット位置が 0 の場合、最初のタブ ストップのオフセットは文字列の原点である 0 が基準になります。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベント ハンドラのパラメータである PaintEventArgse が必要です。このコードは次のアクションを実行します。

• StringFormat のタブ ストップを設定します。

• 文字列とレイアウト四角形を描画します。この文字列にはタブが含まれます。StringFormat のタブ設定によって、タブ付きテキストのオフセットが指定されます。

• タブ ストップを取得し、その値を使用または検査します。

Visual Basic

Public Sub GetSetTabStopsExample2(ByVal
 e As PaintEventArgs)
    Dim g As Graphics = e.Graphics

    ' Tools used for drawing, painting.
    Dim redPen As New Pen(Color.FromArgb(255,
 255, 0, 0))
    Dim blueBrush As New
 SolidBrush(Color.FromArgb(255, 0, 0, 255))

    ' Layout and format for text.
    Dim myFont As New Font("Times
 New Roman", 12)
    Dim myStringFormat As New
 StringFormat
    Dim enclosingRectangle As New
 Rectangle(20, 20, 500, 100)
    Dim tabStops As Single()
 = {150.0F, 100.0F, 100.0F}

    ' Text with tabbed columns.
    Dim myString As String
 = "Name" & ControlChars.Tab & "Tab
 1" _
    & ControlChars.Tab & "Tab 2" & ControlChars.Tab
 & "Tab 3" _
    & ControlChars.Cr & "George Brown" &
 ControlChars.Tab & "One" _
    & ControlChars.Tab & "Two" & ControlChars.Tab
 & "Three"

    ' Set the tab stops, paint the text specified by myString,
    ' and draw rectangle that encloses the text.
    myStringFormat.SetTabStops(0.0F, tabStops)
    g.DrawString(myString, myFont, blueBrush, _
    RectangleF.op_Implicit(enclosingRectangle), myStringFormat)
    g.DrawRectangle(redPen, enclosingRectangle)

    ' Get the tab stops.
    Dim firstTabOffset As Single
    Dim tabStopsObtained As Single()
 = _
    myStringFormat.GetTabStops(firstTabOffset)
    Dim j As Integer
    For j = 0 To tabStopsObtained.Length -
 1

        ' Inspect or use the value in tabStopsObtained[j].
        Console.WriteLine(ControlChars.Cr & "  Tab stop {0}
 = {1}", _
        j, tabStopsObtained(j))
    Next j
End Sub

C#

public void GetSetTabStopsExample2(PaintEventArgs
 e)
{
    Graphics     g = e.Graphics;
             
    // Tools used for drawing, painting.
    Pen          redPen = new Pen(Color.FromArgb(255, 255, 0,
 0));
    SolidBrush   blueBrush = new SolidBrush(Color.FromArgb(255,
 0, 0, 255));
             
    // Layout and format for text.
    Font         myFont = new Font("Times New Roman",
 12);
    StringFormat myStringFormat = new StringFormat();
    Rectangle    enclosingRectangle = new Rectangle(20, 20, 500,
 100);
    float[]      tabStops = {150.0f, 100.0f, 100.0f};
             
    // Text with tabbed columns.
    string       myString =
        "Name\tTab 1\tTab 2\tTab 3\nGeorge Brown\tOne\tTwo\tThree";
             
    // Set the tab stops, paint the text specified by myString, draw
 the
    // rectangle that encloses the text.
    myStringFormat.SetTabStops(0.0f, tabStops);
    g.DrawString(myString, myFont, blueBrush,
        enclosingRectangle, myStringFormat);
    g.DrawRectangle(redPen, enclosingRectangle);
             
    // Get the tab stops.
    float   firstTabOffset;
    float[] tabStopsObtained = myStringFormat.GetTabStops(out
 firstTabOffset);
    for(int j = 0; j < tabStopsObtained.Length;
 j++)
    {
             
        // Inspect or use the value in tabStopsObtained[j].
        Console.WriteLine("\n  Tab stop {0} = {1}", j, tabStopsObtained[j]);
    }
}

C++

void GetSetTabStopsExample2( PaintEventArgs^ e )
{
   Graphics^ g = e->Graphics;

   // Tools used for drawing, painting.
   Pen^ redPen = gcnew Pen( Color::FromArgb( 255, 255, 0, 0 ) );
   SolidBrush^ blueBrush = gcnew SolidBrush( Color::FromArgb( 255, 0, 0, 255 ) );

   // Layout and format for text.
   System::Drawing::Font^ myFont = gcnew System::Drawing::Font( "Times New Roman",12
 );
   StringFormat^ myStringFormat = gcnew StringFormat;
   Rectangle enclosingRectangle = Rectangle(20,20,500,100);
   array<Single>^tabStops = {150.0f,100.0f,100.0f};

   // Text with tabbed columns.
   String^ myString = "Name\tTab 1\tTab 2\tTab 3\nGeorge Brown\tOne\tTwo\tThree";

   // Set the tab stops, paint the text specified by myString, draw
 the
   // rectangle that encloses the text.
   myStringFormat->SetTabStops( 0.0f, tabStops );
   g->DrawString( myString, myFont, blueBrush, enclosingRectangle, myStringFormat
 );
   g->DrawRectangle( redPen, enclosingRectangle );

   // Get the tab stops.
   float firstTabOffset;
   array<Single>^tabStopsObtained = myStringFormat->GetTabStops( firstTabOffset
 );
   for ( int j = 0; j < tabStopsObtained->Length;
 j++ )
   {
      // Inspect or use the value in tabStopsObtained[j].
      Console::WriteLine( "\n  Tab stop {0} = {1}", j, tabStopsObtained[
 j ] );
   }
}

J#

public void GetSetTabStopsExample2(PaintEventArgs
 e)
{
    Graphics g = e.get_Graphics();

    // Tools used for drawing, painting.
    Pen redPen = new Pen(Color.FromArgb(255, 255, 0, 0));
    SolidBrush blueBrush = new SolidBrush(Color.FromArgb(255,
 0, 0, 255));

    // Layout and format for text.
    Font myFont = new Font("Times New Roman", 12);
    StringFormat myStringFormat = new StringFormat();
    Rectangle enclosingRectangle = new Rectangle(20, 20, 500,
 100);
    float tabStops[] =  { 150, 100, 100 };

    // Text with tabbed columns.
    String myString = "Name\tTab 1\tTab 2\tTab 3\nGeorge Brown\tOne\tTwo"
 
                    + "\tThree";

    // Set the tab stops, paint the text specified by myString, draw
 the
    // rectangle that encloses the text.
    myStringFormat.SetTabStops(0, tabStops);
    g.DrawString(myString, myFont, blueBrush, 
        RectangleF.op_Implicit(enclosingRectangle), myStringFormat);
    g.DrawRectangle(redPen, enclosingRectangle);

    // Get the tab stops.
    float firstTabOffset = 0.0F;
    float tabStopsObtained[] = myStringFormat.GetTabStops(firstTabOffset);

    for (int j = 0; j < tabStopsObtained.length;
 j++) {
        // Inspect or use the value in tabStopsObtained[j].
        Console.WriteLine("\n  Tab stop {0} = {1}", 
            System.Convert.ToString(j), 
            System.Convert.ToString(tabStopsObtained.get_Item(j)));
    }
} //GetSetTabStopsExample2

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
StringFormat クラス
StringFormat メンバ
System.Drawing 名前空間