ITextRange::Metode GetChar (tom.h)

Artikel
08/26/2023

Mendapatkan karakter pada posisi awal rentang.

Sintaks

HRESULT GetChar(
  long *pChar
);

Parameter

pChar

Jenis: long*

Posisi karakter awal rentang.

Mengembalikan nilai

Jenis: HRESULT

Metode mengembalikan nilai HRESULT . Jika metode berhasil, metode akan mengembalikan S_OK. Jika pChar null, metode gagal dan mengembalikan E_INVALIDARG.

Keterangan

Contoh Microsoft Visual Basic berikut mengatur ch yang sama dengan karakter di awal rentang.

ch = r.Char

Demikian pula, ITextRange::SetChar menimpa karakter di awal rentang dengan karakter yang ditentukan. Karakter yang diambil dan diatur oleh metode ini adalah variabel LONG , yang menyembunyikan cara mereka disimpan di penyimpanan pendukung (sebagai byte, kata-kata, panjang variabel, dan sebagainya), dan mereka tidak memerlukan penggunaan BSTR.

Properti Char, yang dapat melakukan sebagian besar hal yang dapat dilakukan koleksi karakter, memiliki dua keuntungan besar:

Ini dapat mereferensikan karakter apa pun dalam cerita induk alih-alih terbatas pada rentang induk.
Ini secara signifikan lebih cepat, karena LONGterlibat alih-alih objek rentang.

Dengan demikian, Model Objek Teks (TOM) tidak mendukung kumpulan karakter.

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