Grafis::SetClip(HRGN,CombineMode) metode (gdiplusgraphics.h)

Artikel
08/24/2023

Metode Graphics::SetClip memperbarui wilayah kliping objek Grafis ini ke wilayah yang merupakan kombinasi dari dirinya sendiri dan wilayah Windows Graphics Device Interface (GDI).

Sintaks

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

Parameter

[in] hRgn

Jenis: HRGN

Tangani ke wilayah GDI untuk dikombinasikan dengan wilayah kliping objek Grafis ini. Ini disediakan untuk kode warisan. Aplikasi baru harus meneruskan objek Wilayah sebagai parameter pertama.

[in] combineMode

Jenis: CombineMode

Pilihan. Elemen enumerasi CombineMode yang menentukan bagaimana wilayah GDI dikombinasikan dengan wilayah kliping objek Grafis ini. Nilai defaultnya adalah CombineModeReplace.

Menampilkan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Metode ini mengasumsikan bahwa wilayah GDI yang ditentukan oleh hRgn sudah ada di unit perangkat, sehingga tidak mengubah koordinat wilayah GDI.

Contoh

Contoh berikut menggunakan wilayah GDI untuk memperbarui wilayah kliping.

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);
}

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusgraphics.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll