Fungsi ScriptStringXtoCP (usp10.h)

Mengonversi koordinat x menjadi posisi karakter.

Sintaks

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

Parameter

[in] ssa

Struktur SCRIPT_STRING_ANALYSIS untuk string.

[in] iX

Koordinat x.

[out] piCh

Penunjuk ke variabel di mana fungsi ini mengambil posisi karakter yang sesuai dengan koordinat x.

[out] piTrailing

Penunjuk ke variabel di mana fungsi ini mengambil nilai yang menunjukkan apakah koordinat x adalah untuk tepi depan atau tepi berikutnya dari posisi karakter. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Nilai kembali

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

Keterangan

Jika koordinat x sesuai dengan tepi utama karakter, nilai piTrailing adalah 0. Jika koordinat x sesuai dengan tepi berikutnya dari karakter, nilai piTrailing adalah bilangan bulat positif. Sedangkan untuk ScriptXtoCP, nilainya adalah 1 untuk karakter yang dapat dirender sendiri. Nilainya lebih besar dari 1 jika karakter adalah bagian dari kluster dalam skrip yang kursornya tidak ditempatkan dalam kluster, untuk menunjukkan offset ke posisi kursor logis yang sah berikutnya.

Jika koordinat x adalah sebelum awal baris, fungsi mengambil -1 untuk piCh dan 1 untuk piTrailing, menunjukkan tepi berikutnya dari karakter yang tidak ada sebelum garis. Jika koordinat x setelah akhir baris, fungsi mengambil untuk piCh indeks pertama di luar panjang garis dan 0 untuk piTrailing. Nilai 0 menunjukkan tepi utama karakter yang tidak ada setelah garis.

Persyaratan

Lihat juga

SCRIPT_STRING_ANALYSIS

Uniscribe

Fungsi Uniscribe