Graphics：：SetClip (HRGN，CombineMode) 方法 (gdiplusgraphics.h)

發行項
08/24/2023

Graphics：：SetClip方法會將這個Graphics物件的裁剪區域更新為本身與 Windows 圖形裝置介面 (GDI) 區域的組合區域。

語法

Status SetClip(
  [in] HRGN        hRgn,
  [in] CombineMode combineMode
);

參數

[in] hRgn

類型： HRGN

要與這個 Graphics 物件的裁剪區域結合的 GDI 區域控制碼。這是針對舊版程式碼提供的。新的應用程式應該傳遞 Region 物件做為第一個參數。

[in] combineMode

類型： CombineMode

選擇性。 CombineMode列舉的元素，指定 GDI 區域如何與這個Graphics物件的裁剪區域結合。預設值為 CombineModeReplace。

傳回值

類型：狀態

如果方法成功，它會傳回 Ok，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其中一個其他元素。

備註

此方法假設 hRgn 指定的 GDI 區域已經在裝置單位中，因此它不會轉換 GDI 區域的座標。

範例

下列範例會使用 GDI 區域來更新裁剪區域。

VOID Example_SetClip2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Region object, and get its handle.
   Region region(Rect(0, 0, 100, 100));
   HRGN hRegion = region.GetHRGN(&graphics);

   // Set the clipping region with hRegion.
   graphics.SetClip(hRegion);

   // Fill a rectangle to demonstrate the clipping region.
   graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 500, 500);
}

需求


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