Metode ITextRange::SetText (tom.h)

Artikel
08/26/2023

Menyetel teks dalam rentang ini.

Sintaks

HRESULT SetText(
  [in] BSTR bstr
);

Parameter

[in] bstr

Jenis: BSTR

Teks yang menggantikan teks saat ini dalam rentang ini. Jika null, teks saat ini akan dihapus.

Nilai kembali

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

ITextRange::SetText mengganti teks dalam rentang dengan teks baru. Sebaliknya, TypeText mengganti pilihan dengan bstr teks dan membiarkan pilihan sebagai titik penyisipan hanya mengikuti teks yang disisipkan, seolah-olah Anda telah mengetik teks. Untuk perilaku pemilihan UI, lihat TypeText.

Jika, setelah Anda memanggil ITextRange::SetText, Anda memanggil ITextRange::GetText, Anda mendapatkan kembali teks yang sama dengan metode ITextRange::SetText (kecuali beberapa rentang lain telah mengubah teks tersebut di antara panggilan).

Persyaratan


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