次の方法で共有

ExtTextOutWrap 関数

  • [アーティクル]

[ExtTextOutWrap は、Service Pack 2 (SP2) を使用して Windows XP から入手できます。 以降のバージョンでは、変更または使用できない可能性があります。 代わりに ExtTextOut を直接使用することをお勧めします。

現在選択されているフォント、背景色、テキストの色を使用してテキストを描画します。 必要に応じて、クリッピング、不透明度、またはその両方に使用するディメンションを指定できます。 この関数は ExtTextOut の呼び出しをラップします。

構文

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

パラメーター

hdc [in]

種類: HDC

デバイス コンテキストへのハンドル。

X [入力]

型: int

文字列の配置に使用される参照ポイントの x 座標 (論理座標)。

Y [入力]

型: int

文字列の配置に使用される参照ポイントの y 座標 (論理座標)。

uOptions [in]

型: UINT

アプリケーション定義の四角形の使用方法を指定する値。 オプションの完全な一覧については 、「ExtTextOut 」を参照してください。

lprc [in]

型: const RECT*

クリッピング、不透明度、またはその両方に使用される四角形の次元を論理座標で指定するオプションの RECT 構造体へのポインター。

lpString [in]

種類: LPCTSTR

描画するテキストを含むバッファーへのポインター。 cbCount は文字列の長さを指定するため、文字列を 0 で終える必要はありません。

cbCount [in]

型: UINT

lpString が指す文字列の長さ (バイト単位)。

lpDx [in]

型: const INT*

隣接する文字セルの原点間の距離を示す、省略可能な値の配列へのポインター。 たとえば、 lpDx[x] 論理ユニットは、文字セル x と文字セル (x + 1) の原点を区切ります。

戻り値

種類: BOOL

文字列が正常に描画された場合は、0 以外の値を返します。 ただし、ansi バージョンの ExtTextOut が ETO_GLYPH_INDEX で呼び出された場合、関数は何も行わない場合でも TRUE を 返します。

関数が失敗した場合は、0 を返します。

詳細なエラー情報を得るには、GetLastError を呼び出します。

注釈

ExtTextOutWrap は、名前によってエクスポートされたり、パブリック ヘッダー ファイルで宣言されたりしません。 これを使用するには、 GetProcAddress を 使用し、ComCtl32.dllから序数 417 を要求して関数ポインターを取得する必要があります。

詳細については、「 ExtTextOut」を参照してください。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
[DLL]
Comctl32.dll (バージョン 6.0 以降)