Pena::Metode SetDashPattern (gdipluspen.h)

Artikel
08/24/2023

Metode Pen::SetDashPattern mengatur array tanda hubung dan spasi kustom untuk objek Pena ini.

Sintaks

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

Parameter

[in] dashArray

Jenis: const REAL*

Penunjuk ke array bilangan riil yang menentukan panjang tanda hubung dan spasi kustom. Semua elemen dalam array harus berupa angka riil positif.

[in] count

Jenis: INT

Bilangan bulat yang menentukan jumlah elemen dalam array dashArray . Bilangan bulat harus lebih besar dari 0 dan tidak lebih besar dari jumlah total elemen dalam array.

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

Metode ini akan mengatur enumerasi DashStyle untuk objek Pena ini ke DashStyleCustom.

Elemen dalam array dashArray mengatur panjang setiap tanda hubung dan spasi dalam pola tanda hubung. Elemen pertama mengatur panjang tanda hubung, elemen kedua mengatur panjang spasi, elemen ketiga mengatur panjang tanda hubung, dan sebagainya.

Panjang setiap tanda hubung dan spasi dalam pola tanda hubung adalah produk dari nilai elemen dalam array dan lebar objek Pena .

Contoh

Contoh berikut membuat array bilangan riil. Kode kemudian membuat objek Pena , mengatur pola tanda hubung berdasarkan array, lalu menggambar garis putus-putus kustom.

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

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 0), 5);

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   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