Metode ITextSelection::TypeText (tom.h)

Artikel
03/03/2024

Ketik string yang diberikan oleh bstr pada pilihan ini seolah-olah seseorang mengetiknya. Ini mirip dengan metode SetText yang mendasar, tetapi sensitif terhadap status kunci Insert/Overtype dan pengaturan UI seperti Koreksi Otomatis dan tanda kutip cerdas.

Sintaks

HRESULT TypeText(
  BSTR bstr
);

Parameter

bstr

Jenis: BSTR

String yang akan dititik ke dalam pilihan ini.

Mengembalikan nilai

Jenis: HRESULT

Metode mengembalikan nilai HRESULT . Jika metode berhasil, metode akan mengembalikan S_OK. Jika metode gagal, metode mengembalikan salah satu kode kesalahan berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Teks dilindungi penulisan.
E_INVALIDARG	bstr null.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Metode ini mengetik string yang diberikan oleh bstr pada pilihan ini seolah-olah seseorang mengetiknya. Menggunakan TypeText lebih cepat daripada mengirim karakter melalui fungsi SendMessage , tetapi lebih lambat daripada menggunakan SetText.

TypeText mirip dengan metode SetText yang mendasar, namun, ini sensitif terhadap status kunci Insert/Overtype dan pengaturan UI seperti Koreksi Otomatis dan tanda kutip pintar. Misalnya, ini menghapus pilihan nondegenerasi lalu menyisipkan atau overtype (tergantung pada status kunci Insert/Overtype—lihat metode SetFlags ) string bstr di titik penyisipan, membiarkan pilihan ini sebagai titik penyisipan mengikuti teks yang disisipkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	tom.h
DLL	Msftedit.dll