StringFormat.SetMeasurableCharacterRanges メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

StringFormat.SetMeasurableCharacterRanges メソッド

MeasureCharacterRanges メソッドを呼び出したときに計測される、文字の範囲を表す CharacterRange 構造体の配列を指定します。

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

Visual Basic (宣言)

Public Sub SetMeasurableCharacterRanges ( _
    ranges As CharacterRange() _
)

Visual Basic (使用法)

Dim instance As StringFormat
Dim ranges As CharacterRange()

instance.SetMeasurableCharacterRanges(ranges)

public void SetMeasurableCharacterRanges (
    CharacterRange[] ranges
)

C++

public:
void SetMeasurableCharacterRanges (
    array<CharacterRange>^ ranges
)

public void SetMeasurableCharacterRanges (
    CharacterRange[] ranges
)

JScript

public function SetMeasurableCharacterRanges
 (
    ranges : CharacterRange[]
)

パラメータ

ranges: MeasureCharacterRanges メソッドを呼び出したときに計測される、文字の範囲を表す CharacterRange 構造体の配列。

戻り値
このメソッドは値を返しません。

例外

例外の種類	条件
OverflowException	32 文字を超える範囲が設定されています。

解説

32 文字を超える範囲は設定できないため、System.OverflowException が発生します。

使用例

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

StringFormat の文字範囲を設定します。
指定の文字列またはレイアウト四角形の文字範囲を計測します。
文字列とレイアウト四角形を描画します。
領域を塗りつぶします。各 Region は、文字の範囲に使用される領域を指定します。各領域の値は、文字範囲を MeasureCharacterRanges メソッドで計測したときに設定されます。
最初の 4 つのステップを繰り返します。ただし、各文字範囲の計測時には文字列の末尾の空白が含まれます。
StringFormat の書式フラグを消去します。したがって、各文字範囲の計測時には文字列の末尾の空白は含まれません。
最初の 4 つのステップを繰り返します。ただし、レイアウト四角形が文字範囲の計測に影響を与えることを例示するため、別のレイアウト四角形を使用します。フォントのサイズの計測にも影響を与えます。

Visual Basic

Public Sub SetMeasCharRangesExample(ByVal
 e As PaintEventArgs)
    Dim g As Graphics = e.Graphics
    Dim redBrush As New
 SolidBrush(Color.FromArgb(50, 255, 0, 0))

    ' Layout rectangles, font, and string format used for
    ' displaying string.
    Dim layoutRectA As New
 Rectangle(20, 20, 165, 80)
    Dim layoutRectB As New
 Rectangle(20, 110, 165, 80)
    Dim layoutRectC As New
 Rectangle(20, 200, 240, 80)
    Dim tnrFont As New Font("Times
 New Roman", 16)
    Dim strFormat As New
 StringFormat

    ' Ranges of character positions within a string.
    Dim charRanges As CharacterRange() = {New
 CharacterRange(3, 5), _
    New CharacterRange(15, 2), New CharacterRange(30,
 15)}

    ' Each region specifies the area occupied by the characters within
    ' a range of positions. The values are obtained by using a method
    ' that measures the character ranges.
    Dim charRegions(charRanges.Length) As [Region]

    ' String to be displayed.
    Dim str As String =
 _
    "The quick, brown fox easily jumps over the lazy dog."

    ' Set the char ranges for the string format.
    strFormat.SetMeasurableCharacterRanges(charRanges)

    ' Loop counter (unsigned 8-bit integer).
    Dim i As Byte


    ' Measure the char ranges for a given string and layout rectangle.
    ' Each area occupied by the characters in a range is stored as a
    ' region. then draw the string and layout rectangle and paint the
    ' regions.
    charRegions = g.MeasureCharacterRanges(str, tnrFont, _
    RectangleF.op_Implicit(layoutRectA), strFormat)
    g.DrawString(str, tnrFont, Brushes.Blue, _
    RectangleF.op_Implicit(layoutRectA), strFormat)
    g.DrawRectangle(Pens.Black, layoutRectA)

    ' Paint the regions.
    For i = 0 To charRegions.Length - 1
        g.FillRegion(redBrush, charRegions(i))
    Next i

    ' Repeat the above steps, but include trailing spaces in the char
    ' range measurement by setting the appropriate string format flag.
    strFormat.FormatFlags = StringFormatFlags.MeasureTrailingSpaces
    charRegions = g.MeasureCharacterRanges(str, tnrFont, _
    RectangleF.op_Implicit(layoutRectB), strFormat)
    g.DrawString(str, tnrFont, Brushes.Blue, _
    RectangleF.op_Implicit(layoutRectB), strFormat)
    g.DrawRectangle(Pens.Black, layoutRectB)

    ' Paint the regions.
    For i = 0 To charRegions.Length - 1
        g.FillRegion(redBrush, charRegions(i))
    Next i

    ' Clear all the format flags.
    strFormat.FormatFlags = 0

    ' Repeat the steps, but use a different layout rectangle. The
    ' dimensions of the layout rectangle and the size of the font both
    ' affect the character range measurement.
    charRegions = g.MeasureCharacterRanges(str, tnrFont, _
    RectangleF.op_Implicit(layoutRectC), strFormat)
    g.DrawString(str, tnrFont, Brushes.Blue, _
    RectangleF.op_Implicit(layoutRectC), strFormat)
    g.DrawRectangle(Pens.Black, layoutRectC)

    ' Paint the regions.
    For i = 0 To charRegions.Length - 1
        g.FillRegion(redBrush, charRegions(i))
    Next i
End Sub

public void SetMeasCharRangesExample(PaintEventArgs
 e)
{
    Graphics     g = e.Graphics;
    SolidBrush   redBrush = new SolidBrush(Color.FromArgb(50,
 255, 0, 0));
             
    // Layout rectangles, font, and string format used for displaying
 string.
    Rectangle    layoutRectA = new Rectangle(20, 20, 165, 80);
    Rectangle    layoutRectB = new Rectangle(20, 110, 165, 80);
    Rectangle    layoutRectC = new Rectangle(20, 200, 240, 80);
    Font         tnrFont = new Font("Times New Roman",
 16);
    StringFormat strFormat = new StringFormat();
             
    // Ranges of character positions within a string.
    CharacterRange[] charRanges = { new CharacterRange(3, 5),
        new CharacterRange(15, 2), new CharacterRange(30,
 15)};
             
    // Each region specifies the area occupied by the characters within
 a
    // range of positions. the values are obtained by using a method
 that
    // measures the character ranges.
    Region[]     charRegions = new Region[charRanges.Length];
             
    // String to be displayed.
    string  str =
        "The quick, brown fox easily jumps over the lazy dog.";
             
    // Set the char ranges for the string format.
    strFormat.SetMeasurableCharacterRanges(charRanges);
   
    // loop counter (unsigned 8-bit integer)
    byte  i;    
   
    // Measure the char ranges for a given string and layout rectangle.
 Each
    // area occupied by the characters in a range is stored as a region.
 Then
    // draw the string and layout rectangle, and paint the regions.
    charRegions = g.MeasureCharacterRanges(str, tnrFont,
        layoutRectA, strFormat);
   g.DrawString(str, tnrFont, Brushes.Blue, layoutRectA, strFormat);
    g.DrawRectangle(Pens.Black, layoutRectA);
     
    // Paint the regions.
    for (i = 0; i < charRegions.Length; i++)
        g.FillRegion(redBrush, charRegions[i]);   
   
             
    // Repeat the above steps, but include trailing spaces in the char
    // range measurement by setting the appropriate string format flag.
    strFormat.FormatFlags = StringFormatFlags.MeasureTrailingSpaces;
    charRegions = g.MeasureCharacterRanges(str, tnrFont,
        layoutRectB, strFormat);
    g.DrawString(str, tnrFont, Brushes.Blue, layoutRectB, strFormat);
    g.DrawRectangle(Pens.Black, layoutRectB);
     
    
    for (i = 0; i < charRegions.Length; i++)
        g.FillRegion(redBrush, charRegions[i]);   
   
    // Clear all the format flags.
    strFormat.FormatFlags = 0;                   
 
    // Repeat the steps, but use a different layout rectangle. the dimensions
    // of the layout rectangle and the size of the font both affect
 the
    // character range measurement.
    charRegions = g.MeasureCharacterRanges(str, tnrFont,
        layoutRectC, strFormat);
    g.DrawString(str, tnrFont, Brushes.Blue, layoutRectC, strFormat);
    g.DrawRectangle(Pens.Black, layoutRectC);
    
    // Paint the regions.
    for (i = 0; i < charRegions.Length; i++)
        g.FillRegion(redBrush, charRegions[i]);   
    
}

C++

void SetMeasCharRangesExample( PaintEventArgs^ e )
{
   Graphics^ g = e->Graphics;
   SolidBrush^ redBrush = gcnew SolidBrush( Color::FromArgb( 50, 255, 0, 0 ) );

   // Layout rectangles, font, and string format used for displaying
 string.
   Rectangle layoutRectA = Rectangle(20,20,165,80);
   Rectangle layoutRectB = Rectangle(20,110,165,80);
   Rectangle layoutRectC = Rectangle(20,200,240,80);
   System::Drawing::Font^ tnrFont = gcnew System::Drawing::Font( "Times New
 Roman",16 );
   StringFormat^ strFormat = gcnew StringFormat;

   // Ranges of character positions within a string.
   array<CharacterRange>^ charRanges = {CharacterRange(3,5),CharacterRange(15
,2),CharacterRange(30,15)};

   // Each region specifies the area occupied by the characters within
 a
   // range of positions. the values are obtained by using a method
 that
   // measures the character ranges.
   array<System::Drawing::Region^>^charRegions = gcnew array<System::Drawing::Region^>(charRanges->Length);

   // String to be displayed.
   String^ str = "The quick, brown fox easily jumps over the lazy dog.";

   // Set the char ranges for the string format.
   strFormat->SetMeasurableCharacterRanges( charRanges );

   // loop counter (unsigned 8-bit integer)
   Byte i;

   // Measure the char ranges for a given string and layout rectangle.
 Each
   // area occupied by the characters in a range is stored as a region.
 Then
   // draw the string and layout rectangle, and paint the regions.
   charRegions = g->MeasureCharacterRanges( str, tnrFont, layoutRectA, strFormat
 );
   g->DrawString( str, tnrFont, Brushes::Blue, layoutRectA, strFormat );
   g->DrawRectangle( Pens::Black, layoutRectA );

   // Paint the regions.
   for ( i = 0; i < charRegions->Length; i++ )
      g->FillRegion( redBrush, charRegions[ i ] );

   // Repeat the above steps, but include trailing spaces in the char
   // range measurement by setting the appropriate string format flag.
   strFormat->FormatFlags = StringFormatFlags::MeasureTrailingSpaces;
   charRegions = g->MeasureCharacterRanges( str, tnrFont, layoutRectB, strFormat
 );
   g->DrawString( str, tnrFont, Brushes::Blue, layoutRectB, strFormat );
   g->DrawRectangle( Pens::Black, layoutRectB );
   for ( i = 0; i < charRegions->Length; i++ )
      g->FillRegion( redBrush, charRegions[ i ] );

   // Clear all the format flags.
   strFormat->FormatFlags = StringFormatFlags(0);

   // Repeat the steps, but use a different layout rectangle. the dimensions
   // of the layout rectangle and the size of the font both affect the
   // character range measurement.
   charRegions = g->MeasureCharacterRanges( str, tnrFont, layoutRectC, strFormat
 );
   g->DrawString( str, tnrFont, Brushes::Blue, layoutRectC, strFormat );
   g->DrawRectangle( Pens::Black, layoutRectC );

   // Paint the regions.
   for ( i = 0; i < charRegions->Length; i++ )
      g->FillRegion( redBrush, charRegions[ i ] );
}

public void SetMeasCharRangesExample(PaintEventArgs
 e)
{
    Graphics g = e.get_Graphics();
    SolidBrush redBrush = new SolidBrush(Color.FromArgb(50, 255,
 0, 0));

    // Layout rectangles, font, and string format 
    // used for displaying string.
    Rectangle layoutRectA = new Rectangle(20, 20, 165, 80);
    Rectangle layoutRectB = new Rectangle(20, 110, 165, 80);
    Rectangle layoutRectC = new Rectangle(20, 200, 240, 80);
    Font tnrFont = new Font("Times New Roman", 16);
    StringFormat strFormat = new StringFormat();

    // Ranges of character positions within a string.
    CharacterRange charRanges[] =  { new CharacterRange(3, 5),
 
                                new CharacterRange(15, 2),
                                new CharacterRange(30, 15) };

    // Each region specifies the area occupied by the characters within
 a
    // range of positions. the values are obtained by using a method
 that
    // measures the character ranges.
    Region charRegions[] = new Region[charRanges.length];

    // String to be displayed.
    String str = "The quick, brown fox easily jumps over the lazy dog.";

    // Set the char ranges for the string format.
    strFormat.SetMeasurableCharacterRanges(charRanges);

    // loop counter (unsigned 8-bit integer)
    ubyte i;

    // Measure the char ranges for a given string and layout rectangle.Each
    // area occupied by the characters in a range is stored as a region.
 
    // Then draw the string and layout rectangle, and paint the regions.
    charRegions = g.MeasureCharacterRanges(str, tnrFont, 
                RectangleF.op_Implicit(layoutRectA), strFormat);
    g.DrawString(str, tnrFont, Brushes.get_Blue(), 
        RectangleF.op_Implicit(layoutRectA), strFormat);
    g.DrawRectangle(Pens.get_Black(), layoutRectA);

    // Paint the regions.
    for (i = 0; i < charRegions.length; i++) {
        g.FillRegion(redBrush, charRegions[i]);
    }

    // Repeat the above steps, but include trailing spaces in the char
    // range measurement by setting the appropriate string format flag.
    strFormat.set_FormatFlags(StringFormatFlags.MeasureTrailingSpaces);
    charRegions = g.MeasureCharacterRanges(str, tnrFont, 
                RectangleF.op_Implicit(layoutRectB), strFormat);
    g.DrawString(str, tnrFont, Brushes.get_Blue(), 
        RectangleF.op_Implicit(layoutRectB), strFormat);
    g.DrawRectangle(Pens.get_Black(), layoutRectB);
    for (i = 0; i < charRegions.length; i++) {
        g.FillRegion(redBrush, charRegions[i]);
    }

    // Clear all the format flags.
    strFormat.set_FormatFlags((StringFormatFlags)0);

    // Repeat the steps, but use a different layout rectangle.
    //  the dimensions of the layout rectangle and the size of the font
    //  both affect the character range measurement.
    charRegions = g.MeasureCharacterRanges(str, tnrFont, 
                RectangleF.op_Implicit(layoutRectC), strFormat);
    g.DrawString(str, tnrFont, Brushes.get_Blue(), 
        RectangleF.op_Implicit(layoutRectC), strFormat);
    g.DrawRectangle(Pens.get_Black(), layoutRectC);

    // Paint the regions.
    for (i = 0; i < charRegions.length; i++) {
        g.FillRegion(redBrush, charRegions[i]);
    }
} //SetMeasCharRangesExample

プラットフォーム

バージョン情報

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

参照

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

このページでは「.NET Framework クラスライブラリリファレンス」からStringFormat.SetMeasurableCharacterRanges メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からStringFormat.SetMeasurableCharacterRanges メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からStringFormat.SetMeasurableCharacterRanges メソッドを検索

>> 「StringFormat.SetMeasurableCharacterRanges メソッド」を含む用語の索引
StringFormat.SetMeasurableCharacterRanges メソッドのページへのリンク

StringFormat.SetMeasurableCharacterRanges メソッドとは？わかりやすく解説

StringFormat.SetMeasurableCharacterRanges メソッド

「StringFormat.SetMeasurableCharacterRanges メソッド」の関連用語


	© 2025 Microsoft.All rights reserved.

StringFormat.SetMeasurableCharacterRanges メソッドとは？ わかりやすく解説

StringFormat.SetMeasurableCharacterRanges メソッド

「StringFormat.SetMeasurableCharacterRanges メソッド」の関連用語

StringFormat.SetMeasurableCharacterRanges メソッドとは？わかりやすく解説