Fungsi CreatePen (wingdi.h)

Artikel
08/27/2023

Fungsi CreatePen membuat pena logis yang memiliki gaya, lebar, dan warna yang ditentukan. Pena kemudian dapat dipilih ke dalam konteks perangkat dan digunakan untuk menggambar garis dan kurva.

Sintaks

HPEN CreatePen(
  [in] int      iStyle,
  [in] int      cWidth,
  [in] COLORREF color
);

Parameter

[in] iStyle

Gaya pena. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
PS_SOLID	Penanya padat.
PS_DASH	Penanya putus-putus. Gaya ini hanya valid jika lebar pena adalah satu atau kurang di unit perangkat.
PS_DOT	Penanya putus-putus. Gaya ini hanya valid jika lebar pena adalah satu atau kurang di unit perangkat.
PS_DASHDOT	Pena memiliki tanda hubung dan titik bergantian. Gaya ini hanya valid jika lebar pena adalah satu atau kurang di unit perangkat.
PS_DASHDOTDOT	Pena memiliki tanda hubung bergantian dan titik ganda. Gaya ini hanya valid jika lebar pena adalah satu atau kurang di unit perangkat.
PS_NULL	Pena tidak terlihat.
PS_INSIDEFRAME	Penanya padat. Ketika pena ini digunakan dalam fungsi gambar GDI apa pun yang mengambil persegi panjang pembatas, dimensi gambar disusutkan sehingga sepenuhnya pas di persegi panjang pembatas, dengan mempertimbangkan lebar pena. Ini hanya berlaku untuk pena geometris.

[in] cWidth

Lebar pena, dalam unit logis. Jika nWidth adalah nol, pena adalah lebar piksel tunggal, terlepas dari transformasi saat ini.

CreatePen mengembalikan pena dengan lebar yang ditentukan tetapi dengan gaya PS_SOLID jika Anda menentukan lebar yang lebih besar dari satu pena untuk gaya berikut: PS_DASH, PS_DOT, PS_DASHDOT, PS_DASHDOTDOT.

[in] color

Referensi warna untuk warna pena. Untuk menghasilkan struktur COLORREF , gunakan makro RGB .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel yang mengidentifikasi pena logis.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Setelah aplikasi membuat pena logis, aplikasi dapat memilih pena tersebut ke dalam konteks perangkat dengan memanggil fungsi SelectObject . Setelah pena dipilih ke dalam konteks perangkat, pena dapat digunakan untuk menggambar garis dan kurva.

Jika nilai yang ditentukan oleh parameter nWidth adalah nol, garis yang digambar dengan pena yang dibuat selalu merupakan lebar piksel tunggal terlepas dari transformasi saat ini.

Jika nilai yang ditentukan oleh nWidth lebih besar dari 1, parameter fnPenStyle harus PS_NULL, PS_SOLID, atau PS_INSIDEFRAME.

Jika nilai yang ditentukan oleh nWidth lebih besar dari 1 dan fnPenStyle PS_INSIDEFRAME, garis yang terkait dengan pena digambar di dalam bingkai semua primitif kecuali poligon dan poliline.

Jika nilai yang ditentukan oleh nWidth lebih besar dari 1, fnPenStyle PS_INSIDEFRAME, dan warna yang ditentukan oleh parameter crColor tidak cocok dengan salah satu entri dalam palet logis, sistem menggambar garis dengan menggunakan warna terlarut. Warna terlarut tidak tersedia dengan pena padat.

Saat menggunakan parameter iStyle PS_DASH, PS_DOT, PS_DASHDOT, atau PS_DASHDOTDOT, untuk membuat celah antara tanda hubung atau titik transparan, gunakan SetBkMode untuk mengatur mode ke TRANSPARAN.

Saat Anda tidak lagi memerlukan pena, panggil fungsi DeleteObject untuk menghapusnya.

ICM: Tidak ada manajemen warna yang dilakukan saat pembuatan. Namun, manajemen warna dilakukan ketika pena dipilih ke dalam konteks perangkat berkemampuan ICM.

Contoh

Misalnya, lihat Membuat Pena dan Kuas Berwarna.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll