GraphicsPath::GetBounds(RectF*,constMatrix*,constPen*) metode (gdipluspath.h)

Metode GraphicsPath::GetBounds mendapatkan persegi panjang pembatas untuk jalur ini.

Sintaksis

Status GetBounds(
  RectF        *bounds,
  const Matrix *matrix,
  const Pen    *pen
);

Parameter

bounds

Penunjuk ke objek RectF yang menerima persegi panjang pembatas.

matrix

Fakultatif. Penunjuk ke objek Matriks yang menentukan transformasi yang akan diterapkan ke jalur ini sebelum persegi panjang pembatas dihitung. Jalur ini tidak diubah secara permanen; transformasi hanya digunakan selama proses penghitungan persegi panjang pembatas. Nilai defaultnya adalah NULL.

pen

Fakultatif. Penunjuk ke objek pena yang memengaruhi ukuran persegi panjang pembatas. Persegi panjang pembatas yang diterima dalam batas akan cukup besar untuk mengapit jalur ini ketika jalur digambar dengan pena yang ditentukan oleh parameter ini. Ini memastikan bahwa jalur diapit oleh persegi panjang pembatas bahkan jika jalur digambar dengan pena lebar. Nilai defaultnya adalah NULL.

Mengembalikan 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.

Komentar

Persegi panjang yang dikembalikan oleh metode ini mungkin lebih besar dari yang diperlukan untuk mengapit jalur seperti yang digambar oleh pena yang ditentukan. Persegi panjang dihitung untuk memungkinkan batas mil pena di sudut tajam dan untuk memungkinkan tutup akhir pena.

Contoh

Contoh berikut membuat jalur yang memiliki satu kurva dan satu elips. Kode menggambar jalan dengan pena kuning tebal dan pena hitam tipis. Metode GraphicsPath::GetBounds menerima alamat pena kuning tebal dan menghitung persegi panjang pembatas untuk jalur tersebut. Kemudian kode menggambar persegi panjang pembatas.

VOID GetBoundsExample(HDC hdc)
{
   Graphics graphics(hdc);
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen yellowPen(Color(255, 255, 255, 0), 10);
   Pen redPen(Color(255, 255, 0, 0), 1);

   Point pts[] = {Point(120,120), 
                  Point(200,130), 
                  Point(150,200), 
                  Point(130,180)};

   // Create a path that has one curve and one ellipse.
   GraphicsPath path;
   path.AddClosedCurve(pts, 4);
   path.AddEllipse(120, 220, 100, 40);

   // Draw the path with a thick yellow pen and a thin black pen.
   graphics.DrawPath(&yellowPen, &path);
   graphics.DrawPath(&blackPen, &path);

   // Get the path's bounding rectangle.
   RectF rect;
   path.GetBounds(&rect, NULL, &yellowPen);
   graphics.DrawRectangle(&redPen, rect);  
}

Color(255, 0, 0, 0)Color(255, 255, 0,  0)

Persyaratan

Syarat	Nilai
Header	gdipluspath.h

Lihat juga

Kliping dengan Wilayah

Membuat dan Menggambar Jalur

Membuat Gradien Jalur

GraphicsPath

Matriks

Jalur

Pena

RectF