Pena::SetCompoundArray method (gdipluspen.h)

Artikel
08/24/2023

Metode Pen::SetCompoundArray mengatur array gabungan untuk objek Pena ini.

Sintaks

Status SetCompoundArray(
  [in] const REAL *compoundArray,
  [in] INT        count
);

Parameter

[in] compoundArray

Jenis: const REAL*

Penunjuk ke array bilangan riil yang menentukan array gabungan. Elemen dalam array harus dalam urutan yang meningkat, tidak kurang dari 0, dan tidak lebih besar dari 1.

[in] count

Jenis: INT

Bilangan bulat genap positif yang menentukan jumlah elemen dalam array compoundArray . Bilangan bulat tidak boleh lebih besar dari jumlah elemen dalam array majemuk.

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

Misalkan Anda ingin pena menggambar dua garis paralel di mana lebar baris pertama adalah 20 persen dari lebar pena, lebar ruang yang memisahkan dua baris adalah 50 persen dari lebar pena, dan lebar baris kedua adalah 30 persen dari lebar pena. Mulailah dengan membuat objek Pena dan array bilangan riil. Anda kemudian dapat mengatur array campuran dengan meneruskan array dengan nilai 0,0, 0,2, 0,7, dan 1,0 ke metode Pen::SetCompoundArray dari objek Pena .

Jika Anda mengatur perataan objek Pena ke PenAlignmentInset, Anda tidak dapat menggunakan pena tersebut untuk menggambar garis majemuk.

Contoh

Contoh berikut membuat objek Pena dan mengatur array gabungan untuk pena. Kode kemudian menggambar garis menggunakan objek Pena .

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

   // Create an array of real numbers and a Pen object.
   REAL compVals[6] = {0.0f, 0.2f, 0.5f, 0.7f, 0.9f, 1.0f};
   Pen pen(Color(255, 0, 0, 255), 30);

   // Set the compound array of the pen.
   pen.SetCompoundArray(compVals, 6);

   // Draw a line with the pen.
   graphics.DrawLine(&pen, 5, 20, 405, 200);
}

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