Metode IPrintOemUni::TextOutAsBitmap (prcomoem.h)

Artikel
02/26/2024

Metode ini IPrintOemUni::TextOutAsBitmap memungkinkan plug-in penyajian untuk membuat gambar bitmap string teks, jika font yang dapat diunduh tidak tersedia.

Sintaks

HRESULT TextOutAsBitmap(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  MIX      mix
);

Parameter

pso

Pointer ke struktur SURFOBJ yang menjelaskan permukaan untuk menulis.

pstro

Pointer ke struktur STROBJ yang mendefinisikan glyph yang akan dirender dan posisi untuk menempatkannya.

pfo

Arahkan ke struktur FONTOBJ untuk mengambil informasi tentang font dan glyph-nya.

pco

Penunjuk ke struktur CLIPOBJ yang menentukan wilayah klip tempat semua penyajian harus dilakukan. Driver tidak dapat memengaruhi piksel apa pun di luar wilayah klip.

prclExtra

Penunjuk ke struktur RECTL. GDI selalu mengatur parameter ini ke NULL dalam panggilan ke fungsi ini. Ini harus diabaikan oleh driver.

prclOpaque

Penunjuk ke struktur RECTL yang mewakili persegi panjang buram tunggal. Persegi panjang ini eksklusif kanan bawah. Piksel dalam persegi panjang ini (yang bukan latar depan dan tidak terpotong) akan dirender dengan kuas buram. Persegi panjang ini selalu mengikat teks untuk digambar. Jika parameter ini NULL, tidak ada piksel buram yang akan dirender.

pboFore

Arahkan ke struktur BRUSHOBJ yang mewakili objek kuas yang akan digunakan untuk piksel latar depan. Kuas ini akan selalu menjadi kuas warna padat.

pboOpaque

Pointer ke struktur BRUSHOBJ yang mewakili piksel buram. Mode campuran latar depan dan latar belakang untuk kuas ini diasumsikan R2_COPYPEN. Kecuali driver mengatur kemampuan GCAPS_ARBRUSHOPAQUE sedikit di anggota flGraphicsCaps dari struktur DEVINFO, itu akan selalu dipanggil dengan kuas warna solid.

pptlOrg

Arahkan ke struktur POINTL yang mendefinisikan asal kuas untuk kedua kuas.

mix

Operasi raster latar depan dan latar belakang (mode campuran) untuk pboFore.

Nilai kembali

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::TextOutAsBitmap ini dipanggil dari metode IPrintOemDriverUni::D rvUniTextOut Unidrv , jika metode tersebut tidak dapat membuat string teks menggunakan font yang dapat diunduh, baik karena font tidak tersedia atau diputar. IPrintOemUni::TextOutAsBitmap harus membuat gambar bitmap teks dan mengirimkannya ke perangkat cetak.

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