Pena::SetDashOffset method (gdipluspen.h)

Artikel
02/26/2024

Metode Pena::SetDashOffset mengatur jarak dari awal garis ke awal tanda hubung pertama dalam garis putus-putus.

Sintaks

Status SetDashOffset(
  [in] REAL dashOffset
);

Parameter

[in] dashOffset

Jenis: REAL

Angka riil yang menentukan berapa kali untuk menggeser spasi dalam garis putus-putus. Setiap shift sama dengan panjang spasi dalam garis putus-putus.

Nilai kembali

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

Nilai dashOffset positif menggeser tanda hubung pertama ke depan di sepanjang jalur, dan nilai dashOffset negatif menggeser awal jalur ke depan di sepanjang tanda hubung pertama.

Contoh

Contoh berikut membuat objek Pena , mengatur gaya tanda hubung, dan menggambar garis. Kode kemudian mengatur nilai offset pena dan menggambar baris kedua.

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

   // Create a Pen object, set the dash style, and draw a line.
   Pen pen(Color(255, 0, 0, 255), 15);
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 50);

   // Set the dash offset value for the pen, and draw a second line.
   pen.SetDashOffset(10);
   graphics.DrawLine(&pen, 0, 80, 400, 80);
}

Persyaratan

Persyaratan	Nilai
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