ExtTextOutW

ExtTextOut 関数は、現在選択されているフォント、背景色、テキスト色を使ってテキストを描画する。必要に応じてクリッピングや不透明描画の寸法を指定できる。(Unicode)

ExtTextOutW hdc, x, y, options, lprect, lpString, c, lpDx

hdc : [intptr] デバイスコンテキストのハンドル。
x : [int] 文字列の配置に使用する基準点の x 座標(論理座標)。
y : [int] 文字列の配置に使用する基準点の y 座標(論理座標)。
options : [int] 
lprect : [var] クリッピング、不透明描画、またはその両方に使用する矩形の寸法を論理座標で指定する、省略可能な RECT 構造体へのポインタ。
lpString : [wstr] 描画する文字列へのポインタ。cbCount で長さが指定されるため、NULL 終端である必要はない。
c : [int] lpString が指す文字列の長さ。この値は 8192 を超えてはならない。
lpDx : [var] 隣接する文字セルの原点間の距離を示す、省略可能な値の配列へのポインタ。例えば lpDx[i] 論理単位が、文字セル i と i+1 の原点を隔てる。

(プラグイン / モジュール : gdi32.dll)

解説

ExtTextOut
関数は、現在選択されているフォント、背景色、テキスト色を使ってテキストを描画する。必要に応じてクリッピングや不透明描画の寸法を指定できる。(Unicode)

[戻り値]
文字列が描画された場合、戻り値は 0 以外である。ただし、ExtTextOut の ANSI 版が ETO_GLYPH_INDEX
で呼ばれた場合、関数は何もしなくても TRUE を返す。関数が失敗した場合、戻り値は 0 である。

[備考]
指定されたデバイスコンテキストの現在のテキスト配置設定により、基準点がどのようにテキストの配置に使われるかが決まる。テキスト配置設定は
GetTextAlign 関数で取得でき、SetTextAlign
関数で変更できる。テキスト配置には以下の値を使用できる。水平および垂直配置に影響するフラグから 1
つだけ選択できる。さらに、現在位置を変更する 2 つのフラグのうち 1 つだけ選択できる。
(以下省略)

情報

プラグイン / モジュールgdi32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の gdi32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_gdi32_gen2.hs