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

Artikel
03/04/2024

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

Sintaks

Status GetClipBounds(
  RectF *rect
);

Parameter

rect

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

Nilai kembali

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_GetClipBounds2(HDC hdc)
{
   Graphics graphics(hdc);

   Region   myRegion(RectF(25.0f, 25.0f, 100.0f, 50.0f));
   RectF    rect(40.0f, 60.0f, 100.0f, 50.0f);
   Region   gRegion;
   RectF    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);}