ITextRange::Metode GetIndex (tom.h)

Mengambil indeks cerita parameter Unit pada posisi karakter Mulai rentang yang ditentukan. Unit pertama dalam sebuah cerita memiliki nilai indeks 1. Indeks Unit sama untuk semua posisi karakter dari yang segera mendahului Unit hingga karakter terakhir di Unit.

Sintaks

HRESULT GetIndex(
  long Unit,
  long *pIndex
);

Parameter

Unit

Jenis: panjang

Unit yang diindeks. Untuk daftar nilai Unit yang mungkin, lihat diskusi di bawah ITextRange.

pIndex

Jenis: long*

Nilai indeks. Nilainya nol jika Unit tidak ada.

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.

Keterangan

Metode ITextRange::GetIndex mengambil indeks cerita kata, baris, kalimat, paragraf, dan sebagainya, pada rentang Mulai. Unit menentukan jenis entitas mana yang akan diindeks, seperti kata (tomWord), baris (tomLine), kalimat (tomSentence), atau paragraf (tomParagraph). Misalnya, ITextRange::GetIndex mengatur pIndex sama dengan nomor baris baris baris pertama dalam rentang. Untuk rentang di akhir cerita, ITextRange::GetIndex, mengembalikan jumlah Unitdalam cerita. Dengan demikian, Anda bisa mendapatkan jumlah kata, baris, objek, dan sebagainya, dalam sebuah cerita.

Nilai indeks yang dikembalikan oleh metode ITextRange::GetIndex tidak valid jika teks kemudian diedit. Dengan demikian, pengguna harus berhati-hati dalam menggunakan metode yang mengembalikan nilai indeks, terutama jika nilai akan disimpan selama durasi apa pun. Ini berbeda dengan penunjuk ke rentang, yang tetap valid saat teks diedit.

Persyaratan

Lihat juga

Konseptual

ITextRange

Referensi

Model Objek Teks