Microsoft DirectX 8.0 (Visual Basic)

D3DXFont.DrawTextW

Microsoft® Direct3D® デバイス上に、整形したテキストを描画する。

object.DrawTextW( _ 
    Text As String, _ 
    Count As Long, _ 
    DestRECT As RECT, _ 
    Format As Long, _ 
    Color As Long) As Long

指定項目

object
D3DXFont オブジェクトを表すオブジェクト式。
Text
描画する文字列。
Count
文字列に含まれる文字の数を指定する。Count が -1 の場合、DrawTextW は自動的に文字カウント計算する。Format に DT_MODIFYSTRING が含まれる場合、-1 は指定できない。
DestRECT
RECT 型。整形するテキストが格納される論理座標の四角形を格納する。
Format
テキストの整形方法を指定する、CONST_DTFLAGS 列挙からの値の組み合わせ。Format に DT_MODIFYSTRING が含まれる場合、この文字列には、関数によって最高 4 文字が追加されることがある。文字列を格納するバッファには、これらの追加文字を格納できる十分な大きさが必要である。
Color
テキストのカラーを指定する、D3DCOLORVALUE 型。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

DrawTextW メソッドは、デバイス コンテキストで選択されたフォント、テキスト カラー、バックグラウンド カラーを使用してテキストを描画する。DT_NOCLIP フォーマットが使用される場合を除き、DrawText は指定された四角形の外側にテキストがはみ出ないようテキストをクリップする。DT_SINGLELINE フォーマットが指定されている場合を除き、整形処理では複数行が対象であると見なされる。

選択したフォントが大きすぎて四角形に収まらない場合、DrawTextW メソッドは小さいフォントで置き換える処理を行わない。

DrawTextW メソッドは、escapement と orientation の両方がゼロのフォントのみサポートする。