Navegação com Cursor

Ao trabalhar com um documento, mesmo que seja curto ou longo, você precisará navegar pelo seu documento. Navegação com um cursor virtual representa a capacidade de navegar entre diferentes nós em um documento.

Dentro de um documento curto, mover-se em torno de um documento é simples como você pode mover o ponto de inserção mesmo usando as setas do teclado ou clicando no mouse para localizar o ponto de inserção onde quiser. Mas uma vez que você tem um grande documento que tem muitas páginas, essas técnicas básicas serão insuficientes.

Este artigo explica como se mover em um documento e navegar com um cursor virtual para diferentes partes dele.

Detectando a posição atual do cursor

Antes de iniciar o processo de navegação através do seu documento, você precisará obter o nó que está selecionado atualmente. Você pode obter a posição exata do cursor em um nó selecionado usando o CurrentNode propriedade. Além disso, em vez de obter o nó atual, você pode obter o parágrafo selecionado atualmente ou a seção selecionada usando o CurrentParagraph e CurrentSection propriedades.

Quaisquer operações de inserção que você executar usando o DocumentBuilder será inserido antes do CurrentNode. Quando o parágrafo atual está vazio ou o cursor é posicionado pouco antes do final do parágrafo, o CurrentNode retorna null.

Quando você está editando texto, é importante saber como navegar seu documento e onde exatamente para mover nele. Aspose.Words permite que você se mova em um documento e navegue para suas diferentes seções e partes – isso é semelhante à funcionalidade do painel de navegação em Microsoft Word ir para uma página ou encaminhar em um documento do Word sem rolar.

O método principal é ser capaz de mover a posição do cursor para um nó específico em seu documento, você pode conseguir isso usando o MoveTo método.

O seguinte exemplo de código mostra como mover o DocumentBuilder para nós diferentes em um documento:

Mas além do básico MoveTo método, há mais específicos.

Você pode ir ao início ou ao fim do seu documento usando o MoveToDocumentStart e MoveToDocumentEnd métodos.

O exemplo de código a seguir mostra como mover a posição do cursor para o início ou o fim de um documento:

Você pode marcar um lugar que você quer encontrar e mover para ele novamente facilmente. Você pode inserir tantos marcadores em seu documento como quiser e, em seguida, navegue por eles identificando os favoritos com nomes únicos. Você pode se mover para um marcador usando o MoveToBookmark método.

Os seguintes exemplos de código mostram como mover uma posição do cursor para um marcador:

Você pode se mover para uma célula de tabela usando o MoveToCell método. Este método irá permitir que você navegue seu cursor em qualquer célula em uma tabela específica. Além disso, você pode especificar um índice para mover o cursor para qualquer posição ou caractere especificado em uma célula dentro da MoveToCell método.

O exemplo de código a seguir mostra como mover uma posição do cursor para uma célula de tabela especificada:

Você pode se mover para um campo específico em seu documento usando o MoveToField método. Além disso, você pode se mover para um campo de mesclagem específico usando o MoveToMergeField método.

O exemplo a seguir mostra como mover o cursor do construtor de documentos para um campo específico:

Você pode se mover para o início de um cabeçalho ou rodapé usando o MoveToHeaderFooter método

O exemplo a seguir mostra como mover o cursor do construtor de documentos para um cabeçalho ou rodapé do documento:

Você pode se mover para uma seção ou parágrafo específico usando o MoveToParagraph ou MoveToSection métodos. Além disso, você pode especificar um índice para mover o cursor para qualquer posição ou um caractere especificado em um parágrafo dentro do MoveToParagraph método.

O exemplo a seguir mostra como mover-se para uma seção específica e um parágrafo específico em um documento:

Uso `DocumentBuilder` para inserir elementos de documentos