GetBrushOrgEx

GetBrushOrgEx 関数は、指定したデバイスコンテキストの現在のブラシ原点を取得する。この関数は GetBrushOrg 関数を置き換えるものである。

GetBrushOrgEx hdc, lppt

hdc : [intptr] デバイスコンテキストのハンドル。
lppt : [var] ブラシの原点(デバイス座標)を受け取る POINT 構造体へのポインタ。

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

解説

GetBrushOrgEx 関数は、指定したデバイスコンテキストの現在のブラシ原点を取得する。この関数は GetBrushOrg
関数を置き換えるものである。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。失敗した場合は 0 である。

[備考]
ブラシは、塗りつぶし図形の内部を描画するためにシステムが使用するビットマップである。ブラシの原点は、ビットマップ内の 1
ピクセルの位置を指定する 0 から 7 の座標である。デフォルトのブラシ原点座標は (0,0) である。水平座標の場合、0
は最も左のピクセル列、7 は最も右のピクセル列に対応する。垂直座標の場合、0 は最上行、7
は最下行に対応する。任意の描画操作の開始時にシステムがブラシを配置する際、ブラシ原点で指定された位置がウィンドウのクライアント領域上のブラシ原点
(0,0) にマップされる。例えば原点が (2,3) に設定されていれば、システムはブラシの原点 (0,0)
をウィンドウのクライアント領域上の (2,3)
にマップする。親ウィンドウと子ウィンドウの背景を一致する色のブラシで塗りつぶすアプリケーションでは、親ウィンドウを描画した後、子ウィンドウを描画する前にブラシ原点を設定する必要があるかもしれない。システムはウィンドウ管理されるすべてのデバイスコンテキストのブラシ原点を自動的に追跡し、サーフェス上でパターンの整合を保つよう必要に応じてブラシを調整する。

情報