İmleç ile Gezinme

Bir belgeyle çalışırken, kısa veya uzun olsa bile, belgenizde gezinmeniz gerekir. Sanal imleçle gezinme, bir belgedeki farklı düğümler arasında gezinme yeteneğini temsil eder.

Kısa bir belgede, ekleme noktasını klavyenin ok tuşlarını kullanarak veya ekleme noktasını istediğiniz yere bulmak için fareyi tıklatarak bile taşıyabildiğiniz için belgede dolaşmak basittir. Ancak çok sayıda sayfası olan büyük bir belgeye sahip olduğunuzda, bu temel teknikler yetersiz kalacaktır.

Bu makalede, bir belgede nasıl gezinileceği ve sanal bir imleçle belgenin farklı bölümlerine nasıl gidileceği açıklanmaktadır.

Geçerli İmleç Konumunu Algılama

Belgenizde gezinme işlemine başlamadan önce, o anda seçili olan düğümü almanız gerekir. CurrentNode özelliğini kullanarak imlecin seçili bir düğümdeki tam konumunu alabilirsiniz. Ayrıca, geçerli düğümü almak yerine, CurrentParagraph ve CurrentSection özelliklerini kullanarak seçili paragrafı veya seçili bölümü alabilirsiniz.

DocumentBuilder ‘i kullanarak gerçekleştirdiğiniz tüm ekleme işlemleri CurrentNode‘dan önce eklenir. Geçerli paragraf boş olduğunda veya imleç paragrafın sonundan hemen önce konumlandırıldığında, CurrentNode nullptr değerini döndürür.

Belgede Gezinme Yöntemleri

Metni düzenlerken, belgenizde nasıl gezineceğinizi ve belgede tam olarak nereye taşınacağınızı bilmek önemlidir. Aspose.Words bir belgede dolaşmanıza ve farklı bölümlerine ve bölümlerine gitmenize olanak tanır - bu, bir Word belgesindeki bir sayfaya veya başlığa kaydırmadan gitmek için Microsoft Word içindeki Gezinti Bölmesinin işlevine benzer.

Ana yöntem, imleç konumunu belgenizdeki belirli bir düğüme taşıyabilmektir, bunu MoveTo yöntemini kullanarak başarabilirsiniz.

Aşağıdaki kod örneği, DocumentBuilder‘ın bir belgedeki farklı düğümlere nasıl taşınacağını gösterir:

Ancak temel MoveTo yönteminin yanı sıra daha spesifik olanlar da var.

Belgenin Başına veya Sonuna Gitme

MoveToDocumentStart ve MoveToDocumentEnd yöntemlerini kullanarak belgenizin başına veya sonuna gidebilirsiniz.

Aşağıdaki kod örneği, imleç konumunun bir belgenin başına veya sonuna nasıl taşınacağını gösterir:

Yer imleriyle Gezin

Bulmak istediğiniz bir yeri işaretleyebilir ve kolayca tekrar oraya taşıyabilirsiniz. Belgenize istediğiniz kadar yer imi ekleyebilir ve ardından yer imlerini benzersiz adlarla tanımlayarak bunlar arasında gezinebilirsiniz. MoveToBookmark yöntemini kullanarak bir yer imine geçebilirsiniz.

Aşağıdaki kod örnekleri, imleç konumunun yer imine nasıl taşınacağını gösterir:

Tablo Hücrelerine Git

MoveToCell yöntemini kullanarak bir tablo hücresine taşıyabilirsiniz. Bu yöntem, imlecinizi belirli bir tablodaki herhangi bir hücreye yönlendirmenizi sağlar. Ayrıca, imleci MoveToCell yöntemi içindeki bir hücrede herhangi bir konuma veya belirtilen karaktere taşımak için bir dizin belirtebilirsiniz.

Aşağıdaki kod örneği, imleç konumunun belirli bir tablo hücresine nasıl taşınacağını gösterir:

Bir Alana Git

MoveToField yöntemini kullanarak belgenizdeki belirli bir alana geçebilirsiniz. Ayrıca, MoveToMergeField yöntemini kullanarak belirli bir birleştirme alanına geçebilirsiniz.

Aşağıdaki kod örneği, belge oluşturucu imlecinin belirli bir alana nasıl taşınacağını gösterir:

Üstbilgi veya Altbilgiye Gitme

MoveToHeaderFooter yöntemini kullanarak bir üstbilgi veya altbilginin başına geçebilirsiniz.

Aşağıdaki kod örneği, belge oluşturucu imlecinin belge üstbilgisine veya altbilgisine nasıl taşınacağını gösterir:

Bir Bölüme veya Paragrafa Gitme

MoveToParagraph veya MoveToSection yöntemlerini kullanarak belirli bir bölüme veya paragrafa geçebilirsiniz. Ayrıca, imleci MoveToParagraph yöntemi içindeki bir paragrafta herhangi bir konuma veya belirtilen bir karaktere taşımak için bir dizin belirtebilirsiniz.

Aşağıdaki kod örneği, bir belgedeki belirli bir bölüme ve belirli bir paragrafa nasıl geçileceğini gösterir: