struktur GETINFO_GLYPHSTRING (printoem.h)

Struktur GETINFO_GLYPHSTRING digunakan sebagai input ke fungsi panggilan balik UNIFONTOBJ_GetInfo .

Sintaks

typedef struct _GETINFO_GLYPHSTRING {
  DWORD dwSize;
  DWORD dwCount;
  DWORD dwTypeIn;
  PVOID pGlyphIn;
  DWORD dwTypeOut;
  PVOID pGlyphOut;
  DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;

Anggota

dwSize

Menentukan ukuran, dalam byte, dari struktur GETINFO_GLYPHSTRING . Nilai ini disediakan oleh pemanggil UNIFONTOBJ_GetInfo .

dwCount

Menentukan jumlah elemen dalam array yang ditujukan oleh pGlyphIn dan pGlyphOut. Nilai ini disediakan oleh pemanggil UNIFONTOBJ_GetInfo .

dwTypeIn

Menentukan jenis array penentu glyph yang ditujukkan oleh pGlyphIn. Nilai yang valid adalah sebagai berikut:

Nilai	Definisi
TYPE_GLYPHHANDLE	Elemen arrayPGlyphIn T berjenis HGLYPH, atau menangani glyph font perangkat. Untuk nilai dwTypeIn ini, nilai yang valid untuk dwTypeOut TYPE_UNICODE atau TYPE_TRANSDATA.
TYPE_GLYPHID	Elemen array pGlyphIn berjenis DWORD, dan berisi pengidentifikasi glyph untuk glyph font TrueType yang diunduh. Untuk nilai dwTypeIn ini, nilai yang valid untuk dwTypeOut TYPE_UNICODE atau TYPE_GLYPHHANDLE.

Disediakan oleh penelepon UNIFONTOBJ_GetInfo .

pGlyphIn

Penunjuk ke array penentu glyph. Jenis elemen array ditunjukkan oleh dwTypeIn. Nilai ini disediakan oleh pemanggil UNIFONTOBJ_GetInfo .

dwTypeOut

Menentukan jenis array penentu glyph yang ditujukkan oleh pGlyphOut. Nilai yang valid adalah sebagai berikut:

Nilai	Definisi
TYPE_GLYPHHANDLE	Elemen array pGlyphOut berjenis HGLYPH, atau menangani ke glyph font perangkat. Nilai ini hanya valid ketika dwTypeIn telah diatur ke TYPE_GLYPHID.
TYPE_TRANSDATA	Elemen array pGlyphOut berjenis TRANSDATA. Nilai ini hanya valid ketika dwTypeIn telah diatur ke TYPE_GLYPHHANDLE.
TYPE_UNICODE	Elemen array pGlyph berjenis WCHAR. Nilai ini valid ketika dwTypeIn telah diatur ke TYPE_GLYPHHANDLE atau TYPE_GLYPHID.

Disediakan oleh penelepon UNIFONTOBJ_GetInfo .

pGlyphOut

Penunjuk yang disediakan penelepon ke array kosong penentu glyph. Array diisi oleh fungsi panggilan balik UNIFONTOBJ_GetInfo Unidrv. Jenis elemen array ditunjukkan oleh dwTypeOut. Pointer ini disediakan oleh penelepon UNIFONTOBJ_GetInfo.

dwGlyphOutSize

Menentukan ukuran, dalam byte, dari buffer yang diacu oleh pGlyphOut. Anggota ini hanya digunakan ketika dwTypeIn telah diatur ke TYPE_GLYPHHANDLE dan dwTypeOut telah diatur ke TYPE_TRANSDATA. Lihat bagian Keterangan berikut untuk informasi selengkapnya.

Keterangan

Untuk mengonversi array penentu glyph dari satu jenis ke jenis lainnya, plug-in penyajian dapat menyediakan alamat struktur GETINFO_GLYPHSTRING saat memanggil fungsi panggilan balik UNIFONTOBJ_GetInfo Unidrv.

Jika konversi dari TYPE_GLYPHHANDLE ke TYPE_TRANSDATA, UNIFONTOBJ_GetInfo harus dipanggil dua kali.

• Sebelum panggilan pertama ke UNIFONTOBJ_GetInfo, plug-in penyajian mengisi anggota dwSize, dwCount, dwTypeIn, dan pGlyphIn dan mengatur anggota dwGlyphOutSize ke nol.

  Setelah UNIFONTOBJ_GetInfo kembali, anggota dwGlyphOutSize berisi ukuran, dalam byte, dari buffer yang diperlukan untuk menyimpan string yang dikonversi.

• Plug-in mengalokasikan blok memori ukuran yang diterima di anggota dwGlyphOutSize , mengatur anggota pGlyphOut untuk menunjuk ke blok memori ini, dan memanggil UNIFONTOBJ_GetInfo sekali lagi. UNIDRV kemudian mengonversi string dari TYPE_GLYPHHANDLE ke TYPE_TRANSDATA.

Nilai yang ditentukan plug-in penyajian untuk anggota dwTypeIndan pGlyphIn biasanya adalah yang sebelumnya diterima sebagai parameter dwTypedan pGlyph ke metode IPrintOemUni::OutputCharStr .

Persyaratan

Persyaratan	Nilai
Header	printoem.h (termasuk Printoem.h)

Lihat juga

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo