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 を呼び出す必要があります。 これは、ブラシのずれを避けるために行う必要があります。

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

要件

関連項目

ブラシ関数

ブラシの概要

GetBrushOrgEx

ポイント

Selectobject

SetStretchBltMode

UnrealizeObject