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 |