Fungsi ScriptGetFontFeatureTags (usp10.h)
Mengambil daftar fitur tipografi untuk sistem penulisan yang ditentukan untuk pemrosesan OpenType. Tag fitur tipografi yang terdiri dari daftar diambil dari font dalam konteks perangkat atau cache yang disediakan.
Sintaks
HRESULT ScriptGetFontFeatureTags(
[in, optional] HDC hdc,
[in, out] SCRIPT_CACHE *psc,
[in, optional] SCRIPT_ANALYSIS *psa,
[in] OPENTYPE_TAG tagScript,
[in] OPENTYPE_TAG tagLangSys,
[in] int cMaxTags,
[out] OPENTYPE_TAG *pFeatureTags,
[out] int *pcTags
);
Parameter
[in, optional] hdc
Menangani konteks perangkat. Untuk informasi selengkapnya, lihat Penembolokan.
[in, out] psc
Arahkan ke struktur SCRIPT_CACHE yang mengidentifikasi cache skrip.
[in, optional] psa
Penunjuk ke struktur SCRIPT_ANALYSIS yang diperoleh dari panggilan sebelumnya ke ScriptItemizeOpenType. Parameter ini mengidentifikasi mesin pembentukan, sehingga tag fitur font untuk font dan skrip yang sesuai dapat diambil.
Atau, aplikasi dapat mengatur parameter ini ke NULL untuk mengambil hasil yang tidak difilter.
[in] tagScript
Struktur OPENTYPE_TAG yang menentukan tag skrip yang terkait dengan tag fitur yang ditentukan.
[in] tagLangSys
Struktur OPENTYPE_TAG yang menentukan tag bahasa yang terkait dengan tag fitur yang ditentukan.
[in] cMaxTags
Panjang array yang ditentukan oleh pFeatureTags.
[out] pFeatureTags
Penunjuk ke buffer di mana fungsi ini mengambil array struktur OPENTYPE_TAG yang menentukan tag fitur tipografi yang didukung oleh font dalam konteks perangkat atau cache untuk sistem penulisan yang ditentukan.
[out] pcTags
Arahkan ke jumlah elemen dalam array tag fitur.
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 .
Jika jumlah tag yang cocok melebihi nilai cMaxTags, fungsi gagal dengan E_OUTOFMEMORY. Aplikasi dapat mencoba memanggil lagi dengan buffer yang lebih besar.
Keterangan
Meskipun secara resmi dinyatakan sebagai jenis ULONG, struktur OPENTYPE_TAG berisi array 4-byte yang berisi empat nilai spasi ASCII 8-bit, A-Z, atau a-z. Misalnya, tag fitur untuk fitur Ligatur adalah "liga".
Fungsi ini menyembunyikan fitur yang diperlukan skrip atau bahasa yang diperlukan karena mesin pembentukan mengontrol fitur-fitur ini. Aplikasi tidak memiliki kontrol atas penanganan mesin pembentukan untuk fitur yang diperlukan bahasa. Misalnya, ScriptGetFontFeatureTags menyembunyikan fitur skrip Arab untuk formulir awal, medial, dan akhir.
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk