LinearGradientBrush::GetRectangle(Rect*) metode (gdiplusbrush.h)

Artikel
08/23/2023

Metode LinearGradientBrush::GetRectangle mendapatkan persegi panjang yang menentukan batas gradien.

Sintaks

Status GetRectangle(
  [out] Rect *rect
);

Parameter

[out] rect

Jenis: Rect*

Penunjuk ke objek Rect yang menerima persegi panjang yang menentukan batas gradien. Misalnya, jika kuas gradien linier dibangun dengan titik awal pada (20, 50) dan titik akhir pada (60, 110), maka persegi panjang yang menentukan memiliki titik kiri atas pada (20, 50), lebar 40, dan tinggi 60.

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

Persegi panjang menentukan batas gradien dengan cara berikut: Sisi kanan dan kiri persegi membentuk batas gradien horizontal. Sisi atas dan bawah membentuk batas gradien vertikal. Dua sudut yang berlawanan secara diagonal terletak pada batas gradien diagonal. Dalam setiap kasus ini, kedua sisi/sudut mungkin berada di batas awal, tergantung pada bagaimana titik awal dan akhir diteruskan ke konstruktor.

Contoh

Contoh berikut membuat kuas gradien linier. Kemudian kode mendapatkan persegi panjang kuas dan menggambarnya.

VOID Example_GetRect(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

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	gdiplusbrush.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll