共用方式為


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

另請參閱

筆刷函式

筆刷概觀

GetBrushOrgEx

SelectObject

SetStretchBltMode

UnrealizeObject