SetBrushOrgEx 関数 (wingdi.h)

SetBrushOrgEx 関数は、アプリケーションが選択した次のブラシに GDI が割り当てるブラシの原点を、指定されたデバイスコンテキストに設定します。

構文

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

[in] hdc

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

[in] x

新しいブラシの原点の x 座標 (デバイス単位)。この値がブラシの幅より大きい場合は、modulus 演算子 (nXOrgmod brush width) を使用してその値が小さくなります。

[in] y

新しいブラシの原点の y 座標 (デバイス単位)。この値がブラシの高さより大きい場合、その値は剰余演算子 (nYOrgmod ブラシの高さ) を使用して減少します。

[out] lppt

前のブラシの原点を受け取る POINT 構造体へのポインター。

前のブラシの原点が不要な場合、このパラメーターは NULL にすることができます 。

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

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

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

ブラシの原点は、ビットマップ内の 1 ピクセルの位置を指定する座標のペアです。既定のブラシ原点座標は (0,0) です。水平座標の場合、値 0 はピクセルの左端の列に対応します。幅は右端の列に対応します。垂直座標の場合、値 0 はピクセルの上端行に対応します。高さは一番下の行に対応します。

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

アプリケーションでは、SetStretchBltMode を使用してビットマップストレッチモードを HALFTONE に設定した後、SetBrushOrgEx を呼び出す必要があります。これは、ブラシのずれを避けるために行う必要があります。

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


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