Bagikan melalui

Metode ITextRange::D elete (tom.h)

  • Artikel

Menilik tombol DELETE dan BACKSPACE, dengan dan tanpa tombol CTRL tertekan.

Sintaks

HRESULT Delete(
  long Unit,
  long Count,
  long *pDelta
);

Parameter

Unit

Jenis: panjang

Unit yang akan digunakan. Unit dapat berupa tomCharacter (nilai default) atau tomWord.

Count

Jenis: panjang

Jumlah Unityang akan dihapus. Jika Count= zero, itu hanya menghapus teks dalam rentang. Jika Count lebih besar dari nol, ITextRange::D elete bertindak seolah-olah tombol DELETE ditekan Hitungan waktu. Jika Count kurang dari nol, itu bertindak seolah-olah tombol BACKSPACE ditekan Hitungan waktu. Nilai default adalah 1. Untuk informasi selengkapnya, lihat Keterangan.

pDelta

Jenis: long*

Jumlah unit yang dihapus. Batasan bisa null. Parameter pDelta diatur sama dengan jumlah Units yang dihapus. Menghapus teks dalam rentang nondegenerasi dihitung sebagai satu Unit.

Nilai kembali

Jenis: HRESULT

Metode ini mengembalikan nilai HRESULT . Jika berhasil, ia mengembalikan S_OK. Jika tidak, ia mengembalikan salah satu nilai berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan di COM.

Menampilkan kode Deskripsi
E_ACCESSDENIED
 Teks dilindungi-tulis.
S_FALSE
 Kegagalan karena alasan lain.

Keterangan

Jika Hitungan = nol, metode ini menghapus teks dalam rentang, artinya, tidak menghapus apa pun jika rentang hanya titik penyisipan.

Jika Count bukan nol, dan rentangnya adalah titik penyisipan (yaitu, degenerasi), | Hitung| (nilai absolut Count) Units dihapus dalam arah logis yang diberikan oleh tanda Hitungan, di mana nilai positif adalah arah menuju akhir cerita, dan nilai negatif adalah menuju awal cerita.

Jika Count bukan nol, dan rentangnya nondegenerasi (berisi teks), teks dalam rentang dihapus (terlepas dari nilai Unit dan Hitungan), sehingga membuat titik penyisipan. Kemudian, | Hitung| - 1 Unitdihapus dalam arah logis yang diberikan oleh tanda Hitungan.

Teks dalam rentang juga dapat dihapus dengan menetapkan string null ke rentang (menjalankan pernyataan r = di mana adalah rentang). Namun, ITextRange::D elete tidak memerlukan alokasi BSTR.

Menghapus tanda akhir paragraf (CR) menghasilkan perilaku khusus UI Microsoft Word. Empat kasus menarik minat tertentu:

  • Jika Anda hanya menghapus CR tetapi paragraf menyertakan teks, maka CR dihapus, dan paragraf berikut mendapatkan pemformatan paragraf yang sama dengan saat ini.
  • Jika Anda menghapus CR serta beberapa, tetapi tidak semua, dari karakter dalam paragraf berikut, karakter yang tersisa dari paragraf saat ini mendapatkan pemformatan paragraf dari paragraf berikut.
  • Jika Anda memilih di akhir paragraf, tetapi bukan seluruh paragraf, CR tidak dihapus.
  • Jika Anda menghapus seluruh paragraf (dari awal hingga CR), Anda juga menghapus CR (kecuali itu adalah CR akhir dalam file).

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

Lihat juga

Konseptual

ITextRange

Referensi

Model Objek Teks