Navegação com Cursor

Ao trabalhar com um documento, mesmo que seja curto ou longo, você precisará navegar pelo documento. A 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 um documento é simples, pois você pode mover o ponto de inserção usando as teclas de seta do teclado ou clicando com o mouse para localizar o ponto de inserção onde desejar. Mas quando você tiver um documento grande com muitas páginas, essas técnicas básicas serão insuficientes.

Este artigo explica como navegar 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 pelo seu documento, você precisará obter o nó que está selecionado no momento. Você pode obter a posição exata do cursor em um nó selecionado usando a propriedade current_node. Além disso, em vez de obter o nó atual, você pode obter o parágrafo atualmente selecionado ou a seção atualmente selecionada usando as propriedades current_paragraph e current_section.

Quaisquer operações de inserção executadas usando o DocumentBuilder serão inseridas antes do current_node. Quando o parágrafo atual está vazio ou o cursor está posicionado logo antes do final do parágrafo, o current_node retorna None.

Ao editar texto, é importante saber como navegar no documento e para onde exatamente se mover nele. Aspose.Words permite que você se mova em um documento e navegue por suas diferentes seções e partes – isso é semelhante à funcionalidade do Painel de Navegação no Microsoft Word para ir para uma página ou título em um documento do Word sem rolar.

O método principal é poder mover a posição do cursor para um nó específico em seu documento. Você pode conseguir isso usando o método move_to.

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

Mas além do método move_to básico, existem outros mais específicos.

Você pode ir para o início ou final do seu documento usando os métodos move_to_document_start e move_to_document_end.

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

Você pode marcar um local que deseja encontrar e movê-lo novamente com facilidade. Você pode inserir quantos marcadores desejar em seu documento e navegar por eles identificando os marcadores com nomes exclusivos. Você pode ir para um marcador usando o método move_to_bookmark.

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

Você pode mover para uma célula da tabela usando o método move_to_cell. Este método permitirá que você navegue com o cursor em qualquer célula de 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 do método move_to_cell.

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

Você pode ir para um campo específico em seu documento usando o método move_to_field. Além disso, você pode passar para um campo de mesclagem específico usando o método move_to_merge_field.

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

Você pode ir para o início de um cabeçalho ou rodapé usando o método move_to_header_footer

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

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

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