Fungsi ScriptCPtoX (usp10.h)

Artikel
03/13/2024

Menghasilkan offset x dari ujung kiri atau tepi depan eksekusi ke tepi awal atau akhir kluster karakter logis.

Sintaks

HRESULT ScriptCPtoX(
  [in]  int                   iCP,
  [in]  BOOL                  fTrailing,
  [in]  int                   cChars,
  [in]  int                   cGlyphs,
  [in]  const WORD            *pwLogClust,
  [in]  const SCRIPT_VISATTR  *psva,
  [in]  const int             *piAdvance,
  [in]  const SCRIPT_ANALYSIS *psa,
  [out] int                   *piX
);

Parameter

[in] iCP

Posisi karakter logis dalam eksekusi. Parameter ini sesuai dengan offset karakter logis apa pun dalam kluster.

[in] fTrailing

TRUE untuk menggunakan tepi berikutnya dari kluster karakter logis untuk menghitung offset. Parameter ini diatur ke FALSE untuk menggunakan tepi utama kluster karakter logis.

[in] cChars

Jumlah karakter dalam eksekusi.

[in] cGlyphs

Jumlah glyph dalam eksekusi.

[in] pwLogClust

Arahkan ke kluster logis.

[in] psva

Arahkan ke array SCRIPT_VISATTR atribut visual.

[in] piAdvance

Penunjuk ke nilai lebar lanjutan.

[in] psa

Penunjuk ke struktur SCRIPT_ANALYSIS . Anggota fLogicalOrder menentukan akhir eksekusi untuk mengukur offset. Jika bendera diatur, tepi depan eksekusi akan digunakan. Jika bendera tidak diatur, ujung kiri eksekusi akan digunakan.

[out] piX

Arahkan ke buffer tempat fungsi mengambil posisi x tanda sisipan.

Mengembalikan nilai

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

Keterangan

Tepi awal atau akhir karakter dan tepi utama eksekusi bergantung pada arah teks dalam eksekusi.

Untuk skrip di mana tanda sisipan secara konvensional ditempatkan di tengah kluster (misalnya, Arab dan Ibrani), posisi x karat yang diambil dapat menjadi posisi terinterpolasi untuk titik kode apa pun di baris.

Untuk skrip di mana tanda sisipan secara konvensional diposisikan ke batas kluster (misalnya, Thailand dan India), posisi x diposisikan ke tepi kluster yang diminta yang berisi posisi karakter logis yang ditunjukkan oleh iCP.

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 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	usp10.h
Pustaka	Usp10.lib
DLL	Usp10.dll
Redistribusi	Internet Explorer 5 atau yang lebih baru pada Windows Me/98/95

Lihat juga