Struktur EXTLOGPEN (wingdi.h)

Struktur EXTLOGPEN mendefinisikan gaya pena, lebar, dan atribut kuas untuk pena yang diperluas. Struktur ini digunakan oleh fungsi GetObject ketika mengambil deskripsi pena yang dibuat ketika aplikasi yang disebut fungsi ExtCreatePen .

Sintaks

typedef struct tagEXTLOGPEN {
  DWORD     elpPenStyle;
  DWORD     elpWidth;
  UINT      elpBrushStyle;
  COLORREF  elpColor;
  ULONG_PTR elpHatch;
  DWORD     elpNumEntries;
  DWORD     elpStyleEntry[1];
} EXTLOGPEN, *PEXTLOGPEN, *NPEXTLOGPEN, *LPEXTLOGPEN;

Anggota

elpPenStyle

Kombinasi jenis pena, gaya, gaya tutup akhir, dan gaya gabungan. Nilai dari setiap kategori dapat diambil dengan menggunakan operator AND bitwise dengan masker yang sesuai.

Anggota elpPenStyle yang ditutupi dengan PS_TYPE_MASK memiliki salah satu nilai jenis pena berikut.

Anggota elpPenStyle yang ditutupi dengan PS_STYLE_MASK memiliki salah satu nilai gaya pena berikut:

Kategori berikut hanya berlaku untuk pena PS_GEOMETRIC. Anggota elpPenStyle yang ditutupi dengan PS_ENDCAP_MASK memiliki salah satu nilai batas akhir berikut.

Kategori berikut hanya berlaku untuk pena PS_GEOMETRIC. Anggota elpPenStyle yang ditutupi dengan PS_JOIN_MASK memiliki salah satu nilai gabungan berikut.

elpWidth

Lebar pena. Jika anggota elpPenStyle PS_GEOMETRIC, nilai ini adalah lebar baris dalam unit logis. Jika tidak, garisnya kosmetik dan nilai ini adalah 1, yang menunjukkan garis dengan lebar satu piksel.

elpBrushStyle

Gaya kuas pena. Nilai anggota elpBrushStyle bisa menjadi salah satu dari berikut ini.

elpColor

Jika elpBrushStyle BS_SOLID atau BS_HATCHED, elpColor menentukan warna di mana pena akan digambar. Untuk BS_HATCHED, fungsi SetBkMode dan SetBkColor menentukan warna latar belakang.

Jika elpBrushStyle BS_HOLLOW atau BS_PATTERN, elpColor diabaikan.

Jika elpBrushStyle BS_DIBPATTERN atau BS_DIBPATTERNPT, kata urutan rendah elpColor menentukan apakah anggota bmiColors dari struktur BITMAPINFO berisi nilai atau indeks RGB eksplisit ke dalam palet logis yang saat ini direalisasikan. Nilai elpColor harus salah satu dari berikut ini.

Makro RGB digunakan untuk menghasilkan struktur COLORREF .

elpHatch

Jika elpBrushStyle BS_PATTERN, elpHatch adalah handel ke bitmap yang menentukan pola.

Jika elpBrushStyle BS_SOLID atau BS_HOLLOW, elpHatch diabaikan.

Jika elpBrushStyle BS_DIBPATTERN, anggota elpHatch adalah handel untuk DIB yang dikemas. Untuk mendapatkan handel ini, aplikasi memanggil fungsi GlobalAlloc dengan GMEM_MOVEABLE (atau LocalAlloc dengan LMEM_MOVEABLE) untuk mengalokasikan blok memori dan kemudian mengisi memori dengan DIB yang dikemas. DIB yang dikemas terdiri dari struktur BITMAPINFO segera diikuti oleh array byte yang menentukan piksel bitmap.

Jika elpBrushStyle BS_DIBPATTERNPT, anggota elpHatch adalah pointer ke DIB yang dikemas. Penunjuk berasal dari blok memori yang dibuat oleh LocalAlloc dengan LMEM_FIXED diatur atau oleh GlobalAlloc dengan set GMEM_FIXED, atau itu adalah penunjuk yang dikembalikan oleh panggilan seperti LocalLock (handle_to_the_dib). DIB yang dikemas terdiri dari struktur BITMAPINFO segera diikuti oleh array byte yang menentukan piksel bitmap.

Jika elpBrushStyle BS_HATCHED, anggota elpHatch menentukan orientasi garis yang digunakan untuk membuat palka. Ini bisa menjadi salah satu nilai berikut.

elpNumEntries

Jumlah entri dalam array gaya di anggota elpStyleEntry . Nilai ini nol jika elpPenStyle tidak menentukan PS_USERSTYLE.

elpStyleEntry[1]

Array gaya yang disediakan pengguna. Array ditentukan dengan panjang terbatas, tetapi digunakan seolah-olah berulang tanpa batas waktu. Entri pertama dalam array menentukan panjang tanda hubung pertama. Entri kedua menentukan panjang celah pertama. Setelah itu, panjang tanda hubung dan celah bergantian.

Jika elpWidth menentukan garis geometris, panjangnya berada dalam unit logis. Jika tidak, garisnya kosmetik dan panjangnya ada di unit perangkat.

Persyaratan

Lihat juga

BITMAPINFO

COLORREF

ExtCreatePen

GetObject

Struktur Pena

Gambaran Umum Pena

RGB

SetBkColor

SetBkMode