Metode IPrintCoreHelperPS::SetFontSubstitution (prcomoem.h)

Artikel
02/26/2024

Metode IPrintCoreHelperPS::SetFontSubstitution menentukan font perangkat untuk dicetak sebagai pengganti font TrueType tertentu.

Sintaks

HRESULT SetFontSubstitution(
  [in] IN PCWSTR pszTrueTypeFontName,
  [in] IN PCWSTR pszDevFontName
);

Parameter

[in] pszTrueTypeFontName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama font TrueType yang valid. Parameter ini tidak boleh NULL.

[in] pszDevFontName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama font perangkat.

Nilai kembali

IPrintCoreHelperPS::GetFontSubstitution harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode membaca opsi untuk fitur yang ditentukan.
E_FAIL	Font yang diminta tidak ada atau bukan font TrueType.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Driver inti tidak dapat melayani permintaan karena memori tidak cukup.
E_UNEXPECTED, atau kode pengembalian lainnya yang tidak tercantum di sini	Driver inti tampaknya dalam keadaan tidak valid. Pemanggil harus mengembalikan kode kegagalan.

Keterangan

Mengatur font perangkat untuk digunakan sebagai pengganti font TrueType tertentu hanya dapat terjadi selama sesi lembar properti perangkat dan hanya jika penggantian UI penuh diaktifkan. Font yang diwakili oleh parameter pszTrueTypeFontName harus berupa font TrueType yang valid dan harus diinstal pada printer. Fonta perangkat yang diwakili oleh parameter pszDevFontName harus merupakan font yang valid untuk printer ini.

Jika pemetaan substitusi untuk font TrueType yang ditentukan sudah ada pada antrean ini, metode SetFontSubstitution akan secara diam-diam menggantikan pemetaan. Untuk menghapus pemetaan substitusi, panggil metode ini dengan nama font TrueType yang ditentukan dalam pszTrueTypeFontName dan dengan NULL yang ditentukan dalam pszDevFontName.

Untuk mendapatkan daftar font perangkat yang valid, buat konteks informasi untuk printer saat ini, dan panggil SetGraphicsMode(hIC, GM_ADVANCED). Kemudian, hitung font perangkat dengan memanggil EnumFontFamilies. Parameter panggilan balik (lihat EnumFontFamProc dalam dokumentasi Microsoft Windows SDK) EnumFontFamilies harus memfilter font perangkat dengan menaikkan penghitung untuk setiap font yang hasilNYA bitwise AND (FontType & TRUETYPE_FONTTYPE) bukan nol. Fungsi SetGraphicsMode, EnumFontFamilies, dan EnumFontFamProc dijelaskan dalam dokumentasi Windows SDK.

Persyaratan

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

Lihat juga

IPrintCoreHelperPS

IPrintCoreHelperPS::GetFontSubstitution

Bagikan melalui