GetBrushOrgEx 関数 (wingdi.h)

[アーティクル]
03/04/2024

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

構文

BOOL GetBrushOrgEx(
  [in]  HDC     hdc,
  [out] LPPOINT lppt
);

パラメーター

[in] hdc

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

[out] lppt

デバイス座標でブラシの原点を受け取る POINT 構造体へのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

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

注釈

ブラシは、塗りつぶされた図形の内部を塗りつぶすためにシステムが使用するビットマップです。

ブラシの原点は、ビットマップ内の 1 ピクセルの位置を指定する 0 ~ 7 の値を持つ座標のセットです。既定のブラシ原点座標は (0,0) です。水平座標の場合、値 0 はピクセルの左端の列に対応します。値 7 は右端の列に対応します。垂直座標の場合、値 0 はピクセルの上端行に対応します。値 7 は、一番下の行に対応します。システムは、描画操作の開始時にブラシを配置すると、ブラシの原点を、ブラシの原点で指定されたウィンドウのクライアント領域の位置にマップします。たとえば、原点が (2,3) に設定されている場合、システムはブラシの原点 (0,0) をウィンドウのクライアント領域の位置 (2,3) にマップします。

アプリケーションでブラシを使用して、親ウィンドウと子ウィンドウの両方の背景に一致する色を塗りつぶす場合は、親ウィンドウを描画した後、子ウィンドウを描画する前にブラシの原点を設定する必要がある場合があります。

システムは、ウィンドウで管理されているすべてのデバイスコンテキストの原点を自動的に追跡し、必要に応じてブラシを調整して、サーフェス上のパターンの配置を維持します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll