Navegación con Cursor

Mientras trabaja con un documento, incluso si es corto o largo, tendrá que navegar a través de su documento. La navegación con un cursor virtual representa la capacidad de navegar entre diferentes nodos en un documento.

Dentro de un documento corto, moverse en un documento es simple, ya que puede mover el punto de inserción incluso utilizando las teclas de flecha del teclado o haciendo clic en el ratón para localizar el punto de inserción donde quiera que desee. Pero una vez que tengas un gran documento que tenga muchas páginas, estas técnicas básicas serán insuficientes.

Este artículo explica cómo moverse en un documento y navegar con un cursor virtual a diferentes partes de él.

Detección de la posición actual del cursor

Antes de iniciar el proceso de navegación a través de su documento, necesitará obtener el nodo que se selecciona actualmente. Puede obtener la posición exacta del cursor en un nodo seleccionado utilizando el CurrentNode propiedad. Además, en lugar de obtener el nodo actual, puede obtener el párrafo seleccionado actualmente o la sección seleccionada utilizando el CurrentParagraph y CurrentSection propiedades.

Cualquier operación de inserción que realice utilizando DocumentBuilder se insertará antes de CurrentNode. Cuando el párrafo actual está vacío o el cursor se coloca justo antes del final del párrafo, el CurrentNode vuelve nulo.

Métodos de navegación en un documento

Cuando usted está editando texto, es importante saber cómo navegar su documento y dónde exactamente moverse en él. Aspose.Words le permite moverse en un documento y navegar a sus diferentes secciones y partes – esto es similar a la funcionalidad del Pan de Navegación en Microsoft Word ir a una página o encabezar en un documento de Word sin desplazarse.

El método principal es poder mover la posición del cursor a un nodo específico en su documento, puede lograrlo utilizando el MoveTo método.

El siguiente ejemplo de código muestra cómo mover el DocumentBuilder en un documento:

Pero además de lo básico MoveTo método, hay más específicos.

Usted puede ir al principio o al final de su documento usando el MoveToDocumentStart y MoveToDocumentEnd métodos.

El siguiente ejemplo de código muestra cómo mover la posición del cursor al principio o al final de un documento:

Puedes marcar un lugar que quieras encontrar y moverte a él de nuevo fácilmente. Puede insertar tantos marcadores en su documento como desee, y luego navegar a través de ellos identificando los marcadores con nombres únicos. Puedes moverte a un marcador usando el MoveToBookmark método.

Los siguientes ejemplos de código muestran cómo mover una posición del cursor a un marcador:

Puede moverse a una celda usando la MoveToCell método. Este método le permitirá navegar su cursor en cualquier célula en una tabla específica. Además, puede especificar un índice para mover el cursor a cualquier posición o caracteres especificados en una celda dentro de la MoveToCell método.

El siguiente ejemplo de código muestra cómo mover una posición del cursor a una celda de tabla especificada:

Puede pasar a un campo específico en su documento utilizando el MoveToField método. Además, puede moverse a un campo de fusión específico utilizando el MoveToMergeField método.

El siguiente ejemplo de código muestra cómo mover el cursor del constructor de documentos a un campo específico:

Usted puede moverse al principio de una cabecera o pie de página utilizando el MoveToHeaderFooter método

El siguiente ejemplo de código muestra cómo mover el cursor del constructor de documentos a un encabezado de documento o un pie de página:

Puede pasar a una sección o párrafo específico utilizando el MoveToParagraph o MoveToSection métodos. Además, puede especificar un índice para mover el cursor a cualquier posición o un carácter especificado en un párrafo dentro del MoveToParagraph método.

El siguiente ejemplo de código muestra cómo pasar a una sección específica y a un párrafo específico en un documento:

Uso `DocumentBuilder` para insertar elementos del documento