Fungsi ScriptSubstituteSingleGlyph (usp10.h)

Artikel
08/26/2023

Memungkinkan penggantian glyph tunggal dengan satu bentuk alternatif dari glyph yang sama untuk pemrosesan OpenType.

Sintaks

HRESULT ScriptSubstituteSingleGlyph(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           OPENTYPE_TAG    tagFeature,
  [in]           LONG            lParameter,
  [in]           WORD            wGlyphId,
  [out]          WORD            *pwOutGlyphId
);

Parameter

[in, optional] hdc

Menangani konteks perangkat. Untuk informasi selengkapnya, lihat Penembolokan.

[in, out] psc

Penunjuk ke struktur SCRIPT_CACHE yang menunjukkan cache skrip.

[in, optional] psa

Penunjuk ke struktur SCRIPT_ANALYSIS yang diperoleh dari panggilan sebelumnya ke ScriptItemizeOpenType. Parameter ini mengidentifikasi mesin pembentukan sehingga glyph pengganti yang benar digunakan.

Atau, aplikasi dapat mengatur parameter ini ke NULL untuk mengambil hasil yang tidak difilter.

[in] tagScript

Struktur OPENTYPE_TAG yang menentukan tag skrip untuk pembentukan.

[in] tagLangSys

Struktur OPENTYPE_TAG yang menentukan tag bahasa untuk pembentukan.

[in] tagFeature

Struktur OPENTYPE_TAG yang mendefinisikan tag fitur yang akan digunakan untuk membentuk glyph alternatif.

[in] lParameter

Referensi ke glyph alternatif untuk menggantikan. Referensi ini adalah indeks ke array yang berisi semua glyph alternatif yang ditentukan dalam fitur, seperti yang diilustrasikan untuk OPENTYPE_FEATURE_RECORD. Array glyph alternatif adalah salah satu item yang diambil oleh ScriptGetFontAlternateGlyphs.

[in] wGlyphId

Pengidentifikasi glyph asli.

[out] pwOutGlyphId

Penunjuk ke lokasi di mana fungsi ini mengambil pengidentifikasi glyph alternatif.

Nilai kembali

Mengembalikan 0 jika berhasil. Fungsi mengembalikan nilai HRESULT bukan nol jika tidak berhasil. Aplikasi dapat menguji nilai pengembalian dengan makro BERHASIL dan GAGAL .

Keterangan

Fungsi ini menggunakan penggantian satu-ke-satu di mana aplikasi dapat mengganti satu glyph dengan satu bentuk alternatif. Paling sering, aplikasi menggunakan fungsi ini untuk mengatur poin atau glyph alternatif di awal atau akhir garis.

Penting Dimulai dengan Windows 8: Untuk mempertahankan kemampuan untuk berjalan pada Windows 7, modul yang menggunakan Uniscribe harus menentukan Usp10.lib sebelum gdi32.lib dalam daftar pustakanya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	usp10.h
Pustaka	Usp10.lib
DLL	Usp10.dll
Redistribusi	Usp10.dll versi 1.600 atau lebih tinggi di Windows XP