CDC::ExtTextOut

[アーティクル]
08/09/2011

現在選択されているフォントを使って四角形領域内に文字列を書き込みます。

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

パラメーター

x
指定文字列の先頭文字の文字セルの論理 x 座標。
y
指定文字列の先頭文字の文字セルの論理 y 座標。
nOptions
四角形の種類。次の値のいずれか 1 つ、両方、またはどちらも指定しない、のどれかです。
- ETO_CLIPPED テキストが四角形でクリップされます。
- ETO_OPAQUE 現在の背景色で四角形が塗りつぶされます。現在の背景色は、SetBkColor メンバー関数を使って設定でき、GetBkColor メンバー関数を使って取得できます。
lpRect
四角形の大きさを決定する RECT 構造体へのポインター。このパラメーターには、NULL を指定できます。このパラメーターには、CRect オブジェクトを渡すこともできます。
lpszString
描画される指定文字列へのポインター。このパラメーターには、CString オブジェクトを渡すこともできます。
nCount
文字列内の文字数を指定します。
lpDxWidths
隣接する文字セルの原点間の距離を示す値の配列のポインター。たとえば、論理単位 lpDxWidths[i] は、i 番目の文字セルと i + 1 番目の文字セルの原点間の距離を示します。 lpDxWidths に NULL を指定したときは、ExtTextOut 関数は文字間に既定の空間をとります。
str
描画される指定文字列を持つ CString オブジェクト。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

現在の背景色で塗りつぶすことで、四角形領域を不透明にできます。さらに、クリップ領域にもできます。

nOptions が 0 で lpRect が NULL のときは、関数は四角形の領域を使わずにデバイスコンテキストにテキストを書き込みます。既定では、この関数は現在位置を参照したり、更新したりしません。アプリケーションで ExtTextOut 関数を呼び出したときに現在位置を更新する場合は、アプリケーションでパラメーター nFlags に TA_UPDATECP を設定して CDC メンバー関数の SetTextAlign 関数を呼び出します。このフラグが設定されると、Windows はこれ以降の ExtTextOut 関数の呼び出しではパラメーター x と y を無視し、代わりに現在位置を使います。アプリケーションが現在位置を更新するために TA_UPDATECP を使ったときは、ExtTextOut 関数は現在位置を、テキストの直前の行の最後の位置、または lpDxWidths で示される配列の最後の要素が指す位置のうちいずれか大きい方に設定します。