Metode IPrintOemUni::OutputCharStr (prcomoem.h)

Artikel
08/07/2023

Metode ini IPrintOemUni::OutputCharStr memungkinkan plug-in penyajian untuk mengontrol pencetakan glyph font.

Sintaks

HRESULT OutputCharStr(
  PDEVOBJ     pdevobj,
  PUNIFONTOBJ pUFObj,
  DWORD       dwType,
  DWORD       dwCount,
  PVOID       pGlyph
);

Parameter

pdevobj

Penunjuk yang disediakan penelepon ke struktur DEVOBJ .

pUFObj

Penunjuk yang disediakan penelepon ke struktur UNIFONTOBJ .

dwType

Nilai yang disediakan penelepon menunjukkan jenis array penentu glyph yang diacu oleh pGlyph. Nilai yang valid adalah sebagai berikut:

Nilai	Definisi
TYPE_GLYPHHANDLE	Elemen array pGlyph adalah handel glyph jenis HGLYPH.
TYPE_GLYPHID	Elemen array pGlyph adalah pengidentifikasi glyph jenis DWORD.

dwCount

Nilai yang disediakan penelepon mewakili jumlah penentu glyph dalam array yang ditunjukkan oleh pGlyph.

pGlyph

Penunjuk yang disediakan penelepon ke array penentu glyph, di mana jenis elemen array ditunjukkan oleh dwType.

Mengembalikan nilai

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_FAIL	Operasi gagal.
E_NOTIMPL	Metode ini tidak diterapkan.

Keterangan

Metode IPrintOemUni::OutputCharStr ini digunakan untuk mendukung printer yang tidak mengenali perintah output karakter berformat PCL, CAPSL, atau PPDS yang didukung oleh Unidrv. Tujuannya adalah untuk memungkinkan plug-in penyajian untuk mengontrol pencetakan glyph font, dan untuk memberikan penggantian glyph jika perlu.

Jika plug-in penyajian mengimplementasikan IPrintOemUni::OutputCharStr metode , Unidrv memanggil metode setiap kali serangkaian karakter siap untuk ditampung.

Metode menerima array penentu glyph. Nilai yang diterima untuk dwType menunjukkan jenis pengidentifikasi.

Jika font yang ditentukan adalah font perangkat, array berisi handel glyph. Handel perlu diterjemahkan ke kode karakter atau perintah, lalu dikirim ke penampung cetak untuk menyebabkan glyph perangkat dicetak.

Jika font yang ditentukan adalah font lunak (TrueType), array berisi pengidentifikasi glyph. Pengidentifikasi mewakili glyph yang diunduh sebelumnya yang perlu dicetak.

Jika font yang ditentukan adalah font perangkat, metode harus melakukan hal berikut:

Alokasikan struktur GETINFO_GLYPHSTRING dengan dwTypeIn diatur ke TYPE_GLYPHHANDLE dan dwTypeOut diatur ke TYPE_TRANSDATA.
Panggil fungsi UNIFONTOBJ_GetInfo , lewati struktur GETINFO_GLYPHSTRING sebagai input, untuk mendapatkan terjemahan glyph sebagai konten struktur TRANSDATA .
Panggil IPrintOemDriverUni::D rvWriteSpoolBuf untuk mengirim konten struktur TRANSDATA ke spooler cetak, untuk mencetak glyph.

Jika font yang ditentukan adalah font lunak, metode hanya dapat memanggil IPrintOemDriverUni::D rvWriteSpoolBuf untuk mengirim perintah ke penampung cetak yang akan menyebabkan glyph yang diunduh sebelumnya yang ditentukan dicetak.

Metode IPrintOemUni::OutputCharStr ini bersifat opsional. Jika plug-in penyajian mengimplementasikan metode ini, metode IPrintOemUni::GetImplementedMethod plug-in harus mengembalikan S_OK ketika menerima "OutputCharStr" sebagai input.

Untuk informasi tambahan, lihat Manajemen Font yang Disesuaikan.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	prcomoem.h (termasuk Prcomoem.h)

Bagikan melalui