DrawString(String,Font,Brush,RectangleF,Int32,StringFormat) メソッド

指定されたテキスト文字列を指定された四角形内に、指定された System.Drawing.Brush オブジェクトと System.Drawing.Font オブジェクトで、指定された System.Drawing.StringFormat オブジェクトの書式設定属性を使用して描画します。

シンタックス

Visual Basic
C#

'宣言
 
Public Overloads Function DrawString( _
   ByVal text As System.String, _
   ByVal font As System.Drawing.Font, _
   ByVal brush As System.Drawing.Brush, _
   ByVal rc As System.Drawing.RectangleF, _
   ByVal firstChar As System.Integer, _
   ByVal sf As System.Drawing.StringFormat _
) As System.Integer

public System.int DrawString( 
   System.string text,
   System.Drawing.Font font,
   System.Drawing.Brush brush,
   System.Drawing.RectangleF rc,
   System.int firstChar,
   System.Drawing.StringFormat sf
)

パラメータ

text: 描画する文字列
font: 描画テキストの外観とサイズを定義する System.Drawing.Font オブジェクト。
brush: 描画テキストの色を定義する System.Drawing.Brush オブジェクト。
rc: 描画テキストの位置をページの左上隅からのポイント数で指定する四角形構造体。
firstChar: レンダリングされる最初の文字のインデックス。
sf: 描画テキストに適用される書式設定属性を指定する System.Drawing.StringFormat オブジェクト。

戻り値の型

指定された四角形に収まらないために出力されなかった最初の文字のインデックス。

解説

sf には、書式設定オプションを指定するプロパティが含まれます。 System.Drawing.StringFormat.Alignment プロパティを使用して水平方向の配置を指定し、 System.Drawing.StringFormat.LineAlignment プロパティを使用して垂直方向の配置を指定します。

System.Drawing.StringFormat.FormatFlags プロパティを使用して切り詰めと折り返しを指定します。

テキストを垂直方向にレンダリングするには、System.Drawing.StringFormatFlags.DirectionVertical を使用します。このフラグを単独で使用すると、テキストが四角形の下から上にレンダリングされます。 System.Drawing.StringFormatFlags.DirectionRightToLeft フラグと組み合わせると、テキストが四角形の上から下にレンダリングされます。

DrawString メソッドは、出力四角形に収まらなかったために印刷されなかった最初の文字のインデックスを返します。この値を使用して、テキストを次のページに、またはページ内の次のフレームに連続的に配置できます。

使用例

次のコードは、長い文字列を複数のページにレンダリングし、 DrawString メソッドからの戻り値を使用して、印刷を続行する位置を決定します。

// 複数のページにまたがる文字列をレンダリングします
for (int start = 0; start < int.MaxValue;)
{
	// 四角形に収まるだけの文字列をレンダリングします
	start = _c1pdf.DrawString(text, font, Brushes.Black, rcPage, start);
		
	// 次のページに移動します
	_c1pdf.NewPage();
}

参照

C1PdfDocument クラス
 C1PdfDocument メンバ
 オーバーロード一覧