setBrushOrgEx 函式 (wingdi.h)

SetBrushOrgEx函式會設定 GDI 指派給應用程式選取至指定裝置內容的下一個筆刷原點。

語法

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

[in] hdc

裝置內容的控制碼。

[in] x

新筆刷原點的 x 座標，以裝置單位表示。如果此值大於筆刷寬度，則會使用模數運算子 (nXOrgmod 筆刷寬度) 來減少其值。

[in] y

新筆刷原點的 Y 座標，以裝置單位表示。如果此值大於筆刷高度，則會使用模數運算子來減少其值， (nYOrgmod 筆刷高度) 。

[out] lppt

接收先前筆刷原點之 POINT 結構的指標。

如果不需要先前的筆刷原點，這個參數可以是 Null 。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

筆刷是系統用來繪製填滿圖案內部的點陣圖。

筆刷原點是一對座標，指定點陣圖中一個圖元的位置。預設筆刷原點座標 (0，0) 。針對水準座標，值 0 會對應至圖元的最左邊資料行;寬度對應至最右邊的資料行。針對垂直座標，值 0 會對應至圖元的最上層資料列;高度會對應至最下層的資料列。

系統會自動追蹤所有視窗管理裝置內容的原點，並視需要調整其筆刷，以維持介面上的圖樣對齊。以這個呼叫設定的筆刷原點相對於工作區的左上角。

應用程式應該在使用SetStretchBltMode將點陣圖延展模式設定為 HALFTONE 之後呼叫SetBrushOrgEx。這必須完成，以避免筆刷對齊錯誤。

系統會自動追蹤所有視窗管理裝置內容的原點，並視需要調整其筆刷，以維持介面上的圖樣對齊。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll