Graphics.MeasureStringとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

Graphics.MeasureString メソッド (String, Font, SizeF, StringFormat)

指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font, _
    layoutArea As SizeF, _
    stringFormat As StringFormat _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim layoutArea As SizeF
Dim stringFormat As StringFormat
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font, layoutArea, stringFormat)
C#
public SizeF MeasureString (
    string text,
    Font font,
    SizeF layoutArea,
    StringFormat stringFormat
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font, 
    SizeF layoutArea, 
    StringFormat^ stringFormat
)
J#
public SizeF MeasureString (
    String text, 
    Font font, 
    SizeF layoutArea, 
    StringFormat stringFormat
)
JScript
public function MeasureString (
    text : String, 
    font : Font, 
    layoutArea : SizeF, 
    stringFormat : StringFormat
) : SizeF

パラメータ

text

計測する文字列。

font

文字列のテキスト形式を定義する Font。

layoutArea

テキストの最大レイアウト領域を指定する SizeF 構造体。

stringFormat

行間など、文字列の書式情報を表す StringFormat。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータおよび stringFormat パラメータで描画されたとおりに返します。

解説解説

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

縦の文字列を囲む縦の四角形が生成されます。

Visual Basic
Public Sub MeasureStringSizeFFormat(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Set maximum layout size.
    Dim layoutSize As New
 SizeF(100.0F, 200.0F)

    ' Set string format.
    Dim newStringFormat As New
 StringFormat
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Measure string.
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    layoutSize, newStringFormat)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F,
 _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0), newStringFormat)
End Sub
C#
public void MeasureStringSizeFFormat(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(100.0F, 200.0F);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize,
 newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F,
 stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new
 PointF(0, 0), newStringFormat);
}
プラットフォームプラットフォーム

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
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド (String, Font)

指定した Font で描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font)
C#
public SizeF MeasureString (
    string text,
    Font font
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font
)
J#
public SizeF MeasureString (
    String text, 
    Font font
)
JScript
public function MeasureString (
    text : String, 
    font : Font
) : SizeF

パラメータ

text

計測する文字列。

font

文字列のテキスト形式を定義する Font。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータで描画されたとおりに返します。

解説解説

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

Visual Basic
Public Sub MeasureStringMin(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Measure string.
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F,
 _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0))
End Sub
C#
public void MeasureStringMin(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F,
 stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new
 PointF(0, 0));
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド (String, Font, SizeF, StringFormat, Int32, Int32)

指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font, _
    layoutArea As SizeF, _
    stringFormat As StringFormat, _
    <OutAttribute> ByRef charactersFitted As
 Integer, _
    <OutAttribute> ByRef linesFilled As
 Integer _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim layoutArea As SizeF
Dim stringFormat As StringFormat
Dim charactersFitted As Integer
Dim linesFilled As Integer
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font, layoutArea, stringFormat, charactersFitted,
 linesFilled)
C#
public SizeF MeasureString (
    string text,
    Font font,
    SizeF layoutArea,
    StringFormat stringFormat,
    out int charactersFitted,
    out int linesFilled
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font, 
    SizeF layoutArea, 
    StringFormat^ stringFormat, 
    [OutAttribute] int% charactersFitted, 
    [OutAttribute] int% linesFilled
)
J#
public SizeF MeasureString (
    String text, 
    Font font, 
    SizeF layoutArea, 
    StringFormat stringFormat, 
    /** @attribute OutAttribute() */ /** @ref */ int charactersFitted,
 
    /** @attribute OutAttribute() */ /** @ref */ int linesFilled
)
JScript
JScript では、値型の引数は参照渡しされません。

パラメータ

text

計測する文字列。

font

文字列のテキスト形式を定義する Font。

layoutArea

テキストの最大レイアウト領域を指定する SizeF 構造体。

stringFormat

行間など、文字列の書式情報を表す StringFormat。

charactersFitted

文字列の文字数。

linesFilled

文字列のテキスト行数。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータおよび stringFormat パラメータで描画されたとおりに返します。

解説解説

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

縦の文字列を囲む縦の四角形が生成されます。

Visual Basic
Public Sub MeasureStringSizeFFormatInts(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Set maximum layout size.
    Dim layoutSize As New
 SizeF(100.0F, 200.0F)

    ' Set string format.
    Dim newStringFormat As New
 StringFormat
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Measure string.
    Dim charactersFitted As Integer
    Dim linesFilled As Integer
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    layoutSize, newStringFormat, charactersFitted, linesFilled)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F,
 _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0), newStringFormat)

    ' Draw output parameters to screen.
    Dim outString As String
 = "chars " & charactersFitted & _
    ", lines " & linesFilled
    e.Graphics.DrawString(outString, stringFont, Brushes.Black, _
    New PointF(100, 0))
End Sub
C#
public void MeasureStringSizeFFormatInts(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(100.0F, 200.0F);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    int charactersFitted;
    int linesFilled;
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize,
 newStringFormat, out charactersFitted, out linesFilled);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F,
 stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new
 PointF(0, 0), newStringFormat);

    // Draw output parameters to screen.
    string outString = "chars " + charactersFitted +
 ", lines " + linesFilled;
    e.Graphics.DrawString(outString, stringFont, Brushes.Black, new
 PointF(100, 0));
}
プラットフォームプラットフォーム

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
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド (String, Font, Int32)

指定した Font で描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font, _
    width As Integer _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim width As Integer
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font, width)
C#
public SizeF MeasureString (
    string text,
    Font font,
    int width
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font, 
    int width
)
J#
public SizeF MeasureString (
    String text, 
    Font font, 
    int width
)
JScript
public function MeasureString (
    text : String, 
    font : Font, 
    width : int
) : SizeF

パラメータ

text

計測する文字列。

font

文字列の書式を定義する Font。

width

文字列の最大幅 (ピクセル単位)。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータで描画されたとおりに返します。

解説解説

width パラメータは、返された SizeF 構造体の幅コンポーネント (Width) の最大値を指定します。width パラメータが文字列の実際の幅よりも小さい場合、返される Width コンポーネントの値は指定の幅に収まる最大文字数を表す値に切り捨てられます。文字列全体を含めるには、返された Height コンポーネントを文字ラップによる文字列の表示が可能になる値に調整します。

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

Visual Basic
Public Sub MeasureStringWidth(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Set maximum width of string.
    Dim stringWidth As Integer
 = 200

    ' Measure string.
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, _
    stringFont, stringWidth)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F,
 _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0))
End Sub
C#
public void MeasureStringWidth(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum width of string.
    int stringWidth = 200;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, stringWidth);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F,
 stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new
 PointF(0, 0));
}
プラットフォームプラットフォーム

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
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド (String, Font, SizeF)

指定したレイアウト領域内に指定した Font で描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font, _
    layoutArea As SizeF _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim layoutArea As SizeF
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font, layoutArea)
C#
public SizeF MeasureString (
    string text,
    Font font,
    SizeF layoutArea
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font, 
    SizeF layoutArea
)
J#
public SizeF MeasureString (
    String text, 
    Font font, 
    SizeF layoutArea
)
JScript
public function MeasureString (
    text : String, 
    font : Font, 
    layoutArea : SizeF
) : SizeF

パラメータ

text

計測する文字列。

font

文字列のテキスト形式を定義する Font。

layoutArea

テキストの最大レイアウト領域を指定する SizeF 構造体。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータで描画されたとおりに返します。

解説解説

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

Visual Basic
Public Sub MeasureStringSizeF(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Set maximum layout size.
    Dim layoutSize As New
 SizeF(200.0F, 50.0F)

    ' Measure string.
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    layoutSize)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F,
 _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0))
End Sub
C#
public void MeasureStringSizeF(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(200.0F, 50.0F);

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F,
 stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new
 PointF(0, 0));
}
プラットフォームプラットフォーム

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
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド (String, Font, Int32, StringFormat)

指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font, _
    width As Integer, _
    format As StringFormat _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim width As Integer
Dim format As StringFormat
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font, width, format)
C#
public SizeF MeasureString (
    string text,
    Font font,
    int width,
    StringFormat format
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font, 
    int width, 
    StringFormat^ format
)
J#
public SizeF MeasureString (
    String text, 
    Font font, 
    int width, 
    StringFormat format
)
JScript
public function MeasureString (
    text : String, 
    font : Font, 
    width : int, 
    format : StringFormat
) : SizeF

パラメータ

text

計測する文字列。

font

文字列のテキスト形式を定義する Font。

width

文字列の最大幅。

format

行間など、文字列の書式情報を表す StringFormat。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータおよび stringFormat パラメータで描画されたとおりに返します。

解説解説

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

縦の文字列を囲む縦の四角形が生成されます。

Visual Basic
Public Sub MeasureStringWidthFormat(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Set maximum width of string.
    Dim stringWidth As Integer
 = 100

    ' Set string format.
    Dim newStringFormat As New
 StringFormat
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Measure string.
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    stringWidth, newStringFormat)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F,
 _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0), newStringFormat)
End Sub
C#
public void MeasureStringWidthFormat(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum width of string.
    int stringWidth = 100;

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, stringWidth,
 newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F,
 stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new
 PointF(0, 0), newStringFormat);
}
プラットフォームプラットフォーム

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
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド (String, Font, PointF, StringFormat)

指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。

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

Visual Basic (宣言)
Public Function MeasureString ( _
    text As String, _
    font As Font, _
    origin As PointF, _
    stringFormat As StringFormat _
) As SizeF
Visual Basic (使用法)
Dim instance As Graphics
Dim text As String
Dim font As Font
Dim origin As PointF
Dim stringFormat As StringFormat
Dim returnValue As SizeF

returnValue = instance.MeasureString(text, font, origin, stringFormat)
C#
public SizeF MeasureString (
    string text,
    Font font,
    PointF origin,
    StringFormat stringFormat
)
C++
public:
SizeF MeasureString (
    String^ text, 
    Font^ font, 
    PointF origin, 
    StringFormat^ stringFormat
)
J#
public SizeF MeasureString (
    String text, 
    Font font, 
    PointF origin, 
    StringFormat stringFormat
)
JScript
public function MeasureString (
    text : String, 
    font : Font, 
    origin : PointF, 
    stringFormat : StringFormat
) : SizeF

パラメータ

text

計測する文字列。

font

文字列のテキスト形式を定義する Font。

origin

文字列の左上隅を表す PointF 構造体。

stringFormat

行間など、文字列の書式情報を表す StringFormat。

戻り値
このメソッドは、text パラメータに指定された文字列のサイズを PageUnit プロパティで指定された単位で表す SizeF 構造体を、font パラメータおよび stringFormat パラメータで描画されたとおりに返します。

解説解説

MeasureString メソッドは独立した文字列で使用するようにデザインされており、グリフの突出に対応するための少量の余白を文字列の前後に含めます。また、DrawString メソッドはグリフのポイントを調整して表示品質を最適化するため、MeasureString で報告されるよりも狭い範囲に文字列が表示される可能性があります。(たとえば、書式設定されたテキストを実装するときに) レイアウト内の隣接する文字列に適したメトリックを取得するには、MeasureCharacterRanges メソッドを使用するか、または StringFormat を受け取る MeasureString メソッドのうちの 1 つを使用し、GenericTypographic を渡します。また、Graphics の TextRenderingHint が AntiAlias である必要があります。

使用例使用例

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

縦の文字列を囲む縦の四角形が生成されます。

Visual Basic
Public Sub MeasureStringPointFFormat(ByVal
 e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String
 = "Measure String"
    Dim stringFont As New
 Font("Arial", 16)

    ' Set point for upper-left corner of string.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim ulCorner As New
 PointF(x, y)

    ' Set string format.
    Dim newStringFormat As New
 StringFormat
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Measure string.
    Dim stringSize As New
 SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    ulCorner, newStringFormat)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), x, y, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    ulCorner, newStringFormat)
End Sub
C#
public void MeasureStringPointFFormat(PaintEventArgs
 e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set point for upper-left corner of string.
    float x = 50.0F;
    float y = 50.0F;
    PointF ulCorner = new PointF(x, y);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, ulCorner, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), x, y, stringSize.Width,
 stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, ulCorner, newStringFormat);
}
プラットフォームプラットフォーム

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
参照参照
関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText
その他の技術情報
フォントとテキストの使用

Graphics.MeasureString メソッド

指定した Font で描画した場合の、指定した文字列を計測します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
Graphics.MeasureString (String, Font) 指定した Font で描画した場合の、指定した文字列を計測します。

.NET Compact Framework によってサポートされています。

Graphics.MeasureString (String, Font, Int32) 指定した Font で描画した場合の、指定した文字列を計測します。
Graphics.MeasureString (String, Font, SizeF) 指定したレイアウト領域内に指定した Font で描画した場合の、指定した文字列を計測します。
Graphics.MeasureString (String, Font, Int32, StringFormat) 指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。
Graphics.MeasureString (String, Font, PointF, StringFormat) 指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。
Graphics.MeasureString (String, Font, SizeF, StringFormat) 指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。
Graphics.MeasureString (String, Font, SizeF, StringFormat, Int32, Int32) 指定した Font を使用し、指定した StringFormat で書式指定して描画した場合の、指定した文字列を計測します。
参照参照

関連項目

Graphics クラス
Graphics メンバ
System.Drawing 名前空間
TextRenderer.MeasureText

その他の技術情報

フォントとテキストの使用

急上昇のことば

四宮ありす
思わず
救出
坂東龍汰
たまゆら
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「Graphics.MeasureString」の関連用語

1
Graphics.MeasureString メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

2
MenuItem.DrawItem イベント
.NET Framework クラス ライブラリ リファレンス
36% |||||

3
DrawItemEventHandler デリゲート
.NET Framework クラス ライブラリ リファレンス
34% |||||

4
MenuItem.OwnerDraw プロパティ
.NET Framework クラス ライブラリ リファレンス
34% |||||

5
DrawItemState 列挙体
.NET Framework クラス ライブラリ リファレンス
16% |||||

6
MeasureItemEventArgs クラス
.NET Framework クラス ライブラリ リファレンス
16% |||||

7
MeasureItemEventArgs.Graphics プロパティ
.NET Framework クラス ライブラリ リファレンス
16% |||||

8
MeasureItemEventArgs.Index プロパティ
.NET Framework クラス ライブラリ リファレンス
16% |||||

9
MeasureItemEventArgs.ItemHeight プロパティ
.NET Framework クラス ライブラリ リファレンス
16% |||||

10
MeasureItemEventArgs.ItemWidth プロパティ
.NET Framework クラス ライブラリ リファレンス
16% |||||

Graphics.MeasureStringのお隣キーワード

Graphics.InterpolationMode プロパティ

Graphics.IntersectClip メソッド

Graphics.IsClipEmpty プロパティ

Graphics.IsVisible メソッド

Graphics.IsVisibleClipEmpty プロパティ

Graphics.MeasureCharacterRanges メソッド

Graphics.MeasureString

Graphics.MeasureString メソッド

Graphics.MultiplyTransform メソッド

Graphics.PageScale プロパティ

Graphics.PageUnit プロパティ

GraphicsPath.AddArc メソッド

GraphicsPath.AddBeziers メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


Graphics.MeasureStringのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS