Fungsi ScriptGetFontLanguageTags (usp10.h)

Artikel
08/26/2023

Mengambil daftar tag bahasa yang tersedia untuk item yang ditentukan dan didukung oleh tag skrip tertentu untuk pemrosesan OpenType. Tag yang terdiri dari daftar diambil dari font dalam konteks perangkat atau cache yang ditentukan.

Sintaks

HRESULT ScriptGetFontLanguageTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pLangsysTags,
  [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 bahasa font untuk font dan skrip yang sesuai dapat diambil.

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

[in] tagScript

Struktur OPENTYPE_TAG yang menentukan tag skrip tempat daftar tag bahasa terkait diminta.

[in] cMaxTags

Panjang array yang ditentukan oleh pLangSysTags.

[out] pLangsysTags

Penunjuk ke buffer tempat fungsi ini mengambil array struktur OPENTYPE_TAG yang mengidentifikasi tag bahasa yang cocok dengan kriteria input.

[out] pcTags

Arahkan ke jumlah elemen dalam array tag bahasa.

Mengembalikan nilai

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 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 bahasa untuk Rumania, Urdu, dan Persia masing-masing adalah "ROM ", "URD ", dan "FAR". Perhatikan bahwa setiap tag berakhir dengan spasi.

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


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