Grafis::GetClipBounds(Rect*) metode (gdiplusgraphics.h)

Artikel
03/05/2024

Metode Graphics::GetClipBounds mendapatkan persegi panjang yang mengapit wilayah kliping objek Grafis ini.

Sintaks

Status GetClipBounds(
  [out] Rect *rect
);

Parameter

[out] rect

Jenis: Rect*

Penunjuk ke objek Rect yang menerima persegi panjang yang mengapit wilayah kliping.

Nilai kembali

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

Transformasi dunia diterapkan ke wilayah kliping dan kemudian persegi panjang penutup dihitung.

Jika Anda tidak secara eksplisit mengatur wilayah kliping objek Grafis , wilayah klipingnya tidak terbatas. Saat wilayah kliping tidak terbatas, Graphics::GetClipBounds mengembalikan persegi besar. Anggota data X dan Y dari persegi panjang tersebut adalah angka negatif besar, dan anggota data Lebar dan Tinggi adalah angka positif yang besar.

Contoh

Contoh berikut mengatur wilayah kliping, mendapatkan persegi panjang yang mengapit wilayah kliping, lalu mengisi persegi panjang.

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

   Region   myRegion(Rect(25, 25, 100, 50));
   Rect     rect(40, 60, 100, 50);
   Region   gRegion;
   Rect     enclosingRect;

   SolidBrush  blueBrush(Color(100, 0, 0, 255));
   Pen         greenPen(Color(255, 0, 255, 0), 1.5f);

   // Modify the region by using a rectangle.
   myRegion.Union(rect);

   // Set the clipping region of the graphics object.
   graphics.SetClip(&myRegion);

   // Now, get the clipping region, and fill it.
   graphics.GetClip(&gRegion);
   graphics.FillRegion(&blueBrush, &gRegion);

   // Get a rectangle that encloses the clipping region, and draw the enclosing
   // rectangle.
   graphics.GetClipBounds(&enclosingRect);
   graphics.ResetClip();
   graphics.DrawRectangle(&greenPen, enclosingRect);}

Persyaratan

Persyaratan	Nilai
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