Metode IPrintCoreHelperUni::SetFontSubstitution (prcomoem.h)

  • Artikel

Metode IPrintCoreHelperUni::SetFontSubstitution menentukan font perangkat yang akan dicetak sebagai ganti font TrueType yang diberikan.

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

IPrintCoreHelperUni::SetFontSubstitution 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, SetFontSubstitution metode 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 di mana hasil 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

IPrintCoreHelperUni

IPrintCoreHelperUni::GetFontSubstitution