Navigation avec le curseur

Tout en travaillant avec un document, même s’il est court ou long, vous devrez naviguer dans votre document. La navigation avec un curseur virtuel représente la capacité de naviguer entre différents nœuds dans un document.

Dans un document court, se déplacer dans un document est simple car vous pouvez déplacer le point d’insertion même en utilisant les touches fléchées du clavier ou en cliquant sur la souris pour localiser le point d’insertion où vous voulez. Mais une fois que vous aurez un grand document qui a beaucoup de pages, ces techniques de base seront insuffisantes.

Cet article explique comment se déplacer dans un document et naviguer avec un curseur virtuel vers différentes parties de celui-ci.

Détecter la position du curseur actuel

Avant de commencer le processus de navigation dans votre document, vous devrez obtenir le nœud qui est actuellement sélectionné. Vous pouvez obtenir la position exacte du curseur sur un noeud sélectionné en utilisant le CurrentNode propriété. En outre, au lieu d’obtenir le noeud actuel, vous pouvez obtenir le paragraphe actuellement sélectionné ou la section actuellement sélectionnée en utilisant le CurrentParagraph et CurrentSection propriétés.

Toutes les opérations d’insertion que vous effectuez en utilisant la DocumentBuilder sera inséré avant le CurrentNode. Lorsque le paragraphe actuel est vide ou que le curseur est positionné juste avant la fin du paragraphe, CurrentNode retourne nul.

Lorsque vous modifiez du texte, il est important de savoir comment naviguer dans votre document et où se déplacer exactement. Aspose.Words vous permet de vous déplacer dans un document et de naviguer dans ses différentes sections et parties – c’est similaire à la fonctionnalité du panneau de navigation dans Microsoft Word pour aller sur une page ou dans un document Word sans défiler.

La méthode principale est de pouvoir déplacer la position du curseur vers un noeud spécifique dans votre document, vous pouvez y parvenir en utilisant le MoveTo méthode.

L’exemple de code suivant montre comment déplacer le DocumentBuilder à différents nœuds dans un document:

Mais en plus de la base MoveTo méthode, il ya des plus spécifiques.

Vous pouvez aller au début ou à la fin de votre document en utilisant MoveToDocumentStart et MoveToDocumentEnd méthodes.

L’exemple de code suivant montre comment déplacer la position du curseur au début ou à la fin d’un document:

Vous pouvez marquer un endroit que vous voulez trouver et déplacer à nouveau facilement. Vous pouvez insérer autant de signets dans votre document que vous le souhaitez, puis naviguer à travers eux en identifiant les signets avec des noms uniques. Vous pouvez passer à un signet en utilisant le MoveToBookmark méthode.

Les exemples de code suivants montrent comment déplacer une position du curseur vers un signet:

Vous pouvez passer à une cellule de table en utilisant la MoveToCell méthode. Cette méthode vous permettra de naviguer dans n’importe quelle cellule d’une table spécifique. En outre, vous pouvez spécifier un index pour déplacer le curseur vers n’importe quelle position ou caractère spécifié dans une cellule dans la MoveToCell méthode.

L’exemple de code suivant montre comment déplacer une position du curseur vers une cellule de table spécifiée:

Vous pouvez passer à un champ spécifique de votre document en utilisant le MoveToField méthode. En outre, vous pouvez passer à un champ de fusion spécifique en utilisant le MoveToMergeField méthode.

L’exemple de code suivant montre comment déplacer le curseur du constructeur de document vers un champ spécifique:

Naviguez vers un en-tête ou un pied de page

Vous pouvez passer au début d’un en-tête ou d’un pied de page en utilisant le MoveToHeaderFooter méthode

L’exemple de code suivant montre comment déplacer le curseur du constructeur de document vers un en-tête ou un pied de page de document:

Vous pouvez passer à une section ou un paragraphe spécifique en utilisant le MoveToParagraph ou MoveToSection méthodes. En outre, vous pouvez spécifier un index pour déplacer le curseur vers n’importe quelle position ou un caractère spécifié dans un paragraphe dans le MoveToParagraph méthode.

L’exemple de code suivant montre comment passer à une section spécifique et à un paragraphe spécifique dans un document:

Utilisation `DocumentBuilder` pour insérer des éléments de document