ITextRange::Metode GetText (tom.h)

Artikel
03/13/2024

Mendapatkan teks biasa dalam rentang ini. Properti Teks adalah properti default antarmuka ITextRange .

Sintaks

HRESULT GetText(
  BSTR *pbstr
);

Parameter

pbstr

Jenis: BSTR*

Teksnya.

Mengembalikan nilai

Jenis: 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_INVALIDARG	pbstr null.
E_OUTOFMEMORY	Memori tidak cukup untuk menahan teks.

Keterangan

Metode ITextRange::GetText mengembalikan teks biasa dalam rentang. Properti Teks adalah properti default untuk ITextRange; ini, secara otomatis dipanggil untuk rentang, seperti dalam contoh Microsoft Visual Basic for Applications (VBA) berikut.

print range

Beberapa contoh di bawah ini menggunakan fakta ini. Metode ITextRange::SetText menggantikan bstr untuk teks rentang. Untuk memproses satu karakter, properti Karakter lebih efisien daripada properti Teks dan tidak memerlukan pembuatan satu rentang karakter untuk menyimpan karakter. Jika rentang berdegenerasi, properti Teks memungkinkan Anda menyisipkan teks dengan mudah. Anda juga dapat menghapus teks dalam rentang, seperti yang diperlihatkan dalam contoh VBA berikut.

range.delete

range = ""

Anda dapat menggunakan properti Teks untuk menyalin teks biasa dari satu tempat ke tempat lain, cukup dengan mengatur satu rentang sama dengan yang lain. (Ini sangat berbeda dari properti Duplikat ; untuk informasi selengkapnya, lihat ITextRange::GetDuplicate). Pernyataan contoh Microsoft Visual Basic berikut mengatur teks dalam rentang1 ke dalam rentang2.

range1 = range2 ' Replace range1's text by range2's

Rentangnya dapat berada dalam cerita yang berbeda atau bahkan dalam aplikasi yang berbeda. Namun, mereka menyiratkan menyalin teks terlebih dahulu ke BSTR dan kemudian dari string itu ke lokasi target. Untuk teks dalam jumlah besar, metode ITextRange::Copy dan ITextRange::P aste bisa lebih cepat, karena dapat melakukan penyalinan langsung dari sumber ke target dan dengan format apa pun yang didukung oleh sumber dan target.

Teks yang dikembalikan oleh properti Teks diberikan dalam Unicode. Tanda akhir paragraf dapat diberikan oleh 0x2029 (Pemisah Paragraf Unicode), atau dengan pengembalian pengangkutan/umpan baris (CR/LF) (0xd, 0xa), atau dengan pengembalian pengangkutan saja, tergantung pada file aslinya. Microsoft Word menggunakan pengembalian pengangkutan saja, kecuali jika membaca pilihan lain dari file, clipboard, atau IDataObject. Tempat penampung untuk objek yang disematkan diberikan oleh karakter khusus, WCH_EMBEDDING, yang memiliki nilai Unicode 0xFFFC.

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