Fungsi ScriptStringOut (usp10.h)
Menampilkan string yang dihasilkan oleh panggilan sebelumnya ke ScriptStringAnalyse dan secara opsional menambahkan penyorotan.
Sintaks
HRESULT ScriptStringOut(
[in] SCRIPT_STRING_ANALYSIS ssa,
[in] int iX,
[in] int iY,
[in] UINT uOptions,
[in, optional] const RECT *prc,
[in] int iMinSel,
[in] int iMaxSel,
[in] BOOL fDisabled
);
Parameter
[in] ssa
Struktur SCRIPT_STRING_ANALYSIS untuk string.
[in] iX
Koordinat x dari titik referensi yang digunakan untuk memposisikan string.
[in] iY
Koordinat y dari titik referensi yang digunakan untuk memposisikan string.
[in] uOptions
Opsi yang menentukan penggunaan persegi panjang yang ditentukan aplikasi. Parameter ini dapat diatur ke 0 atau ke salah satu nilai berikut. Nilai dapat dikombinasikan dengan biner OR.
Nilai | Makna |
---|---|
|
Klip teks ke persegi. |
|
Gunakan warna latar belakang saat ini untuk mengisi persegi. |
[in, optional] prc
Penunjuk ke struktur RECT yang menentukan persegi panjang yang akan digunakan. Jika uOptions diatur ke ETO_OPAQUE dan NULL disediakan untuk rangkaian, fungsi berhasil dan mengembalikan S_OK. Namun, jika aplikasi mengatur uOptions ke ETO_CLIPPING dan menyediakan NULL untuk rrc, fungsi akan mengembalikan E_INVALIDARG. Aplikasi dapat mengatur parameter ini ke NULL untuk menunjukkan bahwa tidak ada opsi yang diperlukan.
[in] iMinSel
Indeks berbasis nol yang menentukan posisi awal dalam string. Tanpa pilihan, aplikasi harus mengatur iMinSel>= iMaxSel.
[in] iMaxSel
Indeks berbasis nol yang menentukan posisi akhir dalam string.
[in] fDisabled
TRUE jika sistem operasi menerapkan penyorotan teks yang dinonaktifkan dengan mengatur warna latar belakang ke COLOR_HIGHLIGHT di belakang semua karakter yang dipilih. Aplikasi dapat mengatur parameter ini ke FALSE jika sistem operasi menerapkan penyorotan teks yang diaktifkan dengan mengatur warna latar belakang ke COLOR_HIGHLIGHT dan warna teks ke COLOR_HIGHLIGHTTEXT untuk setiap karakter yang dipilih.
Nilai kembali
Mengembalikan S_OK jika berhasil. Fungsi mengembalikan nilai HRESULT bukan nol jika tidak berhasil. Aplikasi tidak dapat menguji nilai pengembalian dengan makro BERHASIL dan GAGAL .
Keterangan
Untuk menggunakan fungsi ini, aplikasi perlu menentukan SSA_GLYPHS dalam panggilan aslinya ke ScriptStringAnalyse.
Aplikasi tidak boleh menggunakan SetTextAlign dengan TA_UPDATECP saat menggunakan ScriptStringOut karena teks yang dipilih tidak dapat dirender dengan benar. Jika aplikasi harus menggunakan bendera ini, aplikasi dapat membatalkan pengaturan dan mengatur ulang bendera seperlunya untuk menghindari masalah.
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 |