Pena::Metode GetDashPattern (gdipluspen.h)

Artikel
08/24/2023

Metode Pen::GetDashPattern mendapatkan array tanda hubung kustom dan spasi yang saat ini diatur untuk objek Pena ini.

Sintaks

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

Parameter

[out] dashArray

Jenis: REAL*

Penunjuk ke array yang menerima panjang tanda hubung dan spasi dalam garis putus-putus kustom.

[in] count

Jenis: INT

Bilangan bulat yang menentukan jumlah elemen dalam array dashArray .

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

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 setiap elemen dalam array dan lebar objek Pena .

Contoh

Contoh berikut membuat array bilangan riil dan objek Pena , mengatur pola tanda hubung, dan menggambar garis putus-putus kustom. Kode kemudian mendapatkan pola tanda hubung yang saat ini diatur untuk pena.

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

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

   for(INT j = 0; j < count; ++j)
   {
      // Inspect or use the value in dashValues[j].
   }
   delete [] dashValues;
}

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