Metode IPrintOemDriverUni::D rvUniTextOut (prcomoem.h)

Artikel
02/29/2024

Metode IPrintOemDriverUni::DrvUniTextOut ini disediakan oleh driver Unidrv sehingga plug-in penyajian menggunakan permukaan gambar yang dikelola perangkat dapat dengan mudah menghasilkan string teks.

Sintaks

HRESULT DrvUniTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlBrushOrg,
  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.

pptlBrushOrg

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 IPrintOemDriverUni::DrvUniTextOut ini disediakan oleh Unidrv untuk digunakan dengan merender plug-in yang mendukung permukaan gambar yang dikelola perangkat. Plug-in penyajian semacam itu harus menghubungkan fungsi DrvTextOut Unidrv, dan IPrintOemDriverUni::DrvUniTextOut metode ini dimaksudkan untuk dipanggil dari fungsi pengait itu. Fungsi pengait harus melakukan operasi kliping wilayah teks dan rotasi teks. Kemudian dapat memanggil IPrintOemDriverUni::DrvUniTextOut untuk meminta Unidrv untuk membuat string teks menggunakan font yang dapat diunduh (dan untuk melakukan kliping berbasis glyph).

Jika IPrintOemDriverUni::DrvUniTextOut tidak dapat membuat string teks, baik karena font tidak tersedia atau diputar, itu memanggil metode IPrintOemUni::TextOutAsBitmap plug-in penyajian, yang menggambar string teks sebagai bitmap.

Untuk informasi selengkapnya, lihat Menangani permukaan Device-Managed.

Persyaratan

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

Bagikan melalui