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
ETO_CLIPPED	Klip teks ke persegi.
ETO_OPAQUE	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.

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

Lihat juga

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Uniscribe

Fungsi Uniscribe