Graphics.DrawString メソッド (String, Font, Brush, RectangleF, StringFormat)
指定した StringFormat オブジェクトの書式属性を使用して、指定した Brush オブジェクトおよび Font オブジェクトで、指定した四角形に指定した文字列を描画します。
Overloads Public Sub DrawString( _
ByVal s As String, _ ByVal font As Font, _ ByVal brush As Brush, _ ByVal layoutRectangle As RectangleF, _ ByVal format As StringFormat _)
[C#]
public void DrawString(strings,Fontfont,Brushbrush,RectangleFlayoutRectangle,StringFormatformat);
[C++]
public: void DrawString(String* s,Font* font,Brush* brush,RectangleFlayoutRectangle,StringFormat* format);
[JScript]
public function DrawString(
s : String,font : Font,brush : Brush,layoutRectangle : RectangleF,format : StringFormat);
パラメータ
- s
描画する文字列。 - font
文字列のテキスト形式を定義する Font オブジェクト。 - brush
描画するテキストの色とテクスチャを決定する Brush オブジェクト。 - layoutRectangle
描画するテキストの位置を指定する RectangleF 構造体。 - format
描画するテキストに適用する行間や配置などの書式属性を指定する StringFormat オブジェクト。
戻り値
このメソッドは値を返しません。
解説
s パラメータによって表されるテキストは、 layoutRectangle パラメータによって表される四角形の内部に描画されます。四角形の内部に収まらないテキストは切り捨てられます。
使用例
[Visual Basic, C#] 次の例は、Windows フォームでの使用を意図してデザインされており、 Paint イベント ハンドラのパラメータである PaintEventArgs e が必要です。このコードは次のアクションを実行します。
- 描画する文字列を作成します。
- フォントを Arial (16 ポイント) に定義します。
- 描画に使用する黒いソリッド ブラシを作成します。
- テキストを描画するための四角形を作成します。
- 画面に四角形を描画します。
- 四角形の中心に配置する文字列の書式を設定します。
- フォント、ブラシ、および描画先の四角形を使用して、画面に文字列を描画します。
Public Sub DrawStringRectangleFFormat(e As PaintEventArgs)
' Create string to draw.
Dim drawString As [String] = "Sample Text"
' Create font and brush.
Dim drawFont As New Font("Arial", 16)
Dim drawBrush As New SolidBrush(Color.Black)
' Create rectangle for drawing.
Dim x As Single = 150F
Dim y As Single = 150F
Dim width As Single = 200F
Dim height As Single = 50F
Dim drawRect As New RectangleF(x, y, width, height)
' Draw rectangle to screen.
Dim blackPen As New Pen(Color.Black)
e.Graphics.DrawRectangle(blackPen, x, y, width, height)
' Set format of string.
Dim drawFormat As New StringFormat()
drawFormat.Alignment = StringAlignment.Center
' Draw string to screen.
e.Graphics.DrawString(drawString, drawFont, drawBrush, _
drawRect, drawFormat)
End Sub
[C#]
public void DrawStringRectangleFFormat(PaintEventArgs e)
{
// Create string to draw.
String drawString = "Sample Text";
// Create font and brush.
Font drawFont = new Font("Arial", 16);
SolidBrush drawBrush = new SolidBrush(Color.Black);
// Create rectangle for drawing.
float x = 150.0F;
float y = 150.0F;
float width = 200.0F;
float height = 50.0F;
RectangleF drawRect = new RectangleF( x, y, width, height);
// Draw rectangle to screen.
Pen blackPen = new Pen(Color.Black);
e.Graphics.DrawRectangle(blackPen, x, y, width, height);
// Set format of string.
StringFormat drawFormat = new StringFormat();
drawFormat.Alignment = StringAlignment.Center;
// Draw string to screen.
e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect, drawFormat);
}
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
Graphics クラス | Graphics メンバ | System.Drawing 名前空間 | Graphics.DrawString オーバーロードの一覧