DrawString(String,Font,Color,Rect,Int32,StringFormat) メソッド

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

シンタックス

Visual Basic
C#

'宣言
 
Public Overloads Function DrawString( _
   ByVal text As System.String, _
   ByVal font As Font, _
   ByVal color As System.Windows.Media.Color, _
   ByVal rc As System.Windows.Rect, _
   ByVal firstChar As System.Integer, _
   ByVal sf As StringFormat _
) As System.Integer

public System.int DrawString( 
   System.string text,
   Font font,
   System.Windows.Media.Color color,
   System.Windows.Rect rc,
   System.int firstChar,
   StringFormat sf
)

パラメータ

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

戻り値の型

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

解説

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

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

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

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

使用例

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

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

参照

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