IPrintCoreHelperUni::GetFontSubstitution method (prcomoem.h)

Metode IPrintCoreHelperUni::GetFontSubstitution menunjukkan font perangkat mana, jika ada, yang digunakan sebagai font substitusi untuk font TrueType tertentu.

Sintaks

HRESULT GetFontSubstitution(
  [in]  IN PCWSTR  pszTrueTypeFontName,
  [out] OUT PCWSTR *ppszDevFontName
);

Parameter

[in] pszTrueTypeFontName

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

[out] ppszDevFontName

Penunjuk ke variabel yang menerima alamat string Unicode yang dihentikan null. String ini berisi nama font perangkat yang akan digunakan sebagai pengganti font TrueType yang ditentukan dalam parameter pszFontName . Jika tidak ada font perangkat yang dapat berfungsi sebagai pengganti font TrueType yang ditentukan, parameter ini akan diatur ke NULL.

Nilai kembali

IPrintCoreHelperUni::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

Jika aplikasi mencoba mencetak teks yang menggunakan font TrueType yang ditentukan dalam parameter pszTrueTypeFontName , teks tersebut akan dicetak dalam font perangkat yang ditentukan dalam parameter ppszDevFontName . Nama font perangkat harus berupa fonta yang valid dan terinstal.

Font diidentifikasi dengan nama wajah font-nya, yang muncul di anggota lfFaceName dari struktur LOGFONT .

Untuk mendapatkan daftar font yang tersedia, buat konteks informasi untuk printer saat ini, dan panggil SetGraphicsMode(hIC, GM_ADVANCED). Kemudian hitung font perangkat melalui panggilan ke EnumFontFamilies. Parameter panggilan balik (lihat EnumFontFamProc) dari EnumFontFamilies harus memfilter font perangkat dengan menaikkan penghitung untuk setiap font yang hasilnya bitwise AND (FontType & TRUETYPE_FONTTYPE) bukan nol.

Persyaratan

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

Lihat juga

IPrintCoreHelperUni

IPrintCoreHelperUni::SetFontSubstitution