次の方法で共有


CDC::ExtTextOut

現在選択されているフォントを使って四角形領域内の文字列を作成するには、このメンバー関数を呼び出します。

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 は、現在の背景色で塗りつぶす四角形指定します。( SetBkColorGetBkColor のメンバー関数の現在の背景色を設定し、照会できます)。

  • 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 関数 SetTextAlignTA_UPDATECPに設定 CDC のメンバーを呼び出すことができます。このフラグが設定されていると、Windows は ExtTextOut に、後続の xy が無視され、現在位置を代わりに使用します。現在位置を更新するには、アプリケーションが TA_UPDATECP を使用すると ExtTextOut は、前のテキスト行の末尾または lpDxWidthsが指す配列内の最後の要素で指定された位置より大きい、どのは、現在位置を設定します。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CDC クラス

階層図

CDC::SetTextAlign

CDC::TabbedTextOut

CDC::TextOut

CDC::GetBkColor

CDC::SetBkColor

CDC::SetTextColor

ExtTextOut

RECT 構造体