Navigasi dengan Kursor

Saat bekerja dengan dokumen, meskipun dokumen itu pendek atau panjang, Anda perlu menavigasi dokumen Anda. Navigasi dengan kursor virtual mewakili kemampuan untuk bernavigasi di antara node yang berbeda dalam sebuah dokumen.

Dalam dokumen singkat, bergerak di sekitar dokumen menjadi sederhana karena Anda dapat memindahkan titik penyisipan bahkan dengan menggunakan tombol panah keyboard atau dengan mengklik mouse untuk menemukan titik penyisipan di mana pun Anda inginkan. Tetapi begitu Anda memiliki dokumen besar yang memiliki banyak halaman, teknik dasar ini tidak akan cukup.

Artikel ini menjelaskan cara berpindah-pindah dalam dokumen dan menavigasi dengan kursor virtual ke berbagai bagiannya.

Mendeteksi Posisi Kursor Saat Ini

Sebelum memulai proses menavigasi dokumen Anda, Anda harus mendapatkan simpul yang saat ini dipilih. Anda bisa mendapatkan posisi kursor yang tepat pada simpul yang dipilih dengan menggunakan properti CurrentNode. Selain itu, alih-alih mendapatkan simpul saat ini, Anda bisa mendapatkan paragraf yang saat ini dipilih atau bagian yang saat ini dipilih dengan menggunakan properti CurrentParagraph dan CurrentSection.

Setiap operasi penyisipan yang Anda lakukan menggunakan DocumentBuilder akan disisipkan sebelum CurrentNode. Saat paragraf saat ini kosong atau kursor diposisikan tepat sebelum akhir paragraf, CurrentNode mengembalikan nullptr.

Menavigasi Metode dalam Dokumen

Saat Anda mengedit teks, penting untuk mengetahui cara menavigasi dokumen Anda dan ke mana tepatnya harus memindahkannya. Aspose.Words memungkinkan Anda berpindah-pindah dalam dokumen dan menavigasi ke bagian dan bagiannya yang berbeda-ini mirip dengan fungsionalitas Panel Navigasi di Microsoft Word untuk membuka halaman atau judul dalam dokumen Word tanpa menggulir.

Metode utamanya adalah dapat memindahkan posisi kursor ke simpul tertentu di dokumen Anda, Anda dapat mencapainya dengan menggunakan metode MoveTo.

Contoh kode berikut menunjukkan cara memindahkan DocumentBuilder ke node yang berbeda dalam dokumen:

Tetapi selain metode dasar MoveTo, ada metode yang lebih spesifik.

Anda dapat pergi ke awal atau akhir dokumen Anda menggunakan metode MoveToDocumentStart dan MoveToDocumentEnd.

Contoh kode berikut menunjukkan cara memindahkan posisi kursor ke awal atau akhir dokumen:

Anda dapat menandai tempat yang ingin Anda temukan dan memindahkannya lagi dengan mudah. Anda dapat menyisipkan penanda ke dalam dokumen sebanyak yang Anda inginkan, lalu menavigasinya dengan mengidentifikasi penanda dengan nama unik. Anda dapat pindah ke bookmark dengan menggunakan metode MoveToBookmark.

Contoh kode berikut menunjukkan cara memindahkan posisi kursor ke bookmark:

Arahkan ke Sel Tabel

Anda dapat pindah ke sel tabel dengan menggunakan metode MoveToCell. Metode ini akan memungkinkan Anda untuk mengarahkan kursor ke sel mana pun dalam tabel tertentu. Selain itu, Anda dapat menentukan indeks untuk memindahkan kursor ke posisi mana pun atau karakter tertentu dalam sel dalam metode MoveToCell.

Contoh kode berikut menunjukkan cara memindahkan posisi kursor ke sel tabel tertentu:

Arahkan ke Bidang

Anda dapat memindahkan ke bidang tertentu di dokumen Anda dengan menggunakan metode MoveToField. Selain itu, Anda dapat pindah ke bidang penggabungan tertentu dengan menggunakan metode MoveToMergeField.

Contoh kode berikut menunjukkan cara memindahkan kursor pembuat dokumen ke bidang tertentu:

Anda dapat berpindah ke awal header atau footer dengan menggunakan metode MoveToHeaderFooter.

Contoh kode berikut menunjukkan cara memindahkan kursor pembuat dokumen ke header atau footer dokumen:

Anda dapat berpindah ke bagian atau paragraf tertentu dengan menggunakan metode MoveToParagraph atau MoveToSection. Selain itu, Anda dapat menentukan indeks untuk memindahkan kursor ke posisi mana pun atau karakter tertentu dalam paragraf dalam metode MoveToParagraph.

Contoh kode berikut menunjukkan cara berpindah ke bagian tertentu dan paragraf tertentu dalam dokumen:

Gunakan `DocumentBuilder` untuk Menyisipkan Elemen Dokumen