SetBrushOrgEx

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

SetBrushOrgEx hdc, x, y, lppt

hdc : [intptr] デバイスコンテキストへのハンドル。
x : [int] 新しいブラシ原点の x 座標(デバイス単位)。この値がブラシの幅より大きい場合、その値はモジュロ演算子(nXOrg mod ブラシ幅)を使用して縮小される。
y : [int] 新しいブラシ原点の y 座標(デバイス単位)。この値がブラシの高さより大きい場合、その値はモジュロ演算子(nYOrg mod ブラシ高さ)を使用して縮小される。
lppt : [var] 以前のブラシ原点を受け取る POINT 構造体へのポインタ。以前のブラシ原点が不要な場合、このパラメータは NULL でもよい。

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

解説

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

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。

[備考]
ブラシは、システムが塗りつぶされた図形の内部を塗るために使用するビットマップである。ブラシ原点は、ビットマップ内の 1
ピクセルの位置を指定する座標のペアである。デフォルトのブラシ原点座標は (0,0) である。水平座標の場合、値 0
はピクセルの最左列に対応し、幅は最右列に対応する。垂直座標の場合、値 0
はピクセルの最上行に対応し、高さは最下行に対応する。システムはウィンドウ管理のすべてのデバイスコンテキストの原点を自動的に追跡し、サーフェス上のパターンの位置合わせを維持するために必要に応じてブラシを調整する。この呼び出しで設定されるブラシ原点は、クライアント領域の左上隅からの相対位置である。アプリケーションは、SetStretchBltMode
を使用してビットマップストレッチモードを HALFTONE に設定した後に SetBrushOrgEx
を呼び出すべきである。これはブラシの位置ずれを避けるために行う必要がある。システムはウィンドウ管理のすべてのデバイスコンテキストの原点を自動的に追跡し、サーフェス上のパターンの位置合わせを維持するために必要に応じてブラシを調整する。

情報