Trabalhando com marcadores
Os marcadores identificam em um documento Microsoft Word os locais ou fragmentos que você nomeia e identifica para referência futura. Por exemplo, você pode usar um marcador para identificar o texto que deseja revisar posteriormente. Em vez de percorrer o documento para localizar o texto, você pode acessá-lo usando a caixa de diálogo Marcador.
As ações que podem ser realizadas com marcadores usando Aspose.Words são as mesmas que você pode realizar usando Microsoft Word. Você pode inserir um novo marcador, excluir, mover para um marcador, obter ou definir um nome de marcador, obter ou definir o texto incluído nele.
Insira um marcador
Use StartBookmark e EndBookmark para criar um marcador marcando seu início e fim, respectivamente. Não se esqueça de passar o mesmo nome do marcador para ambos os métodos. Os marcadores em um documento podem se sobrepor e abranger qualquer intervalo. Marcadores mal formados ou com nomes duplicados serão ignorados quando o documento for salvo.
O exemplo de código a seguir mostra como criar um novo marcador:
Obter marcadores
Às vezes é necessário obter uma coleção de marcadores para iterar pelos marcadores ou para outros fins. Use a propriedade Node.Range exposta por qualquer nó de documento que retorne um objeto Range representando a parte do documento contida neste nó. Use este objeto para recuperar um BookmarkCollection e, em seguida, use o indexador de coleção para obter um indicador específico.
O exemplo de código a seguir mostra como obter marcadores de uma coleção de marcadores:
O exemplo de código a seguir mostra como obter ou definir um nome e texto de marcador:
O exemplo de código a seguir mostra como marcar uma tabela:
Se você alterar o nome de um marcador para um nome já existente no documento, nenhum erro será gerado e apenas o primeiro marcador será armazenado quando você salvar o documento.
Observe que alguns marcadores no documento são atribuídos a campos de formulário. Mover para esse marcador e inserir texto nele insere o texto no código do campo do formulário. Embora isso não invalide o campo do formulário, o texto inserido não ficará visível porque se tornará parte do código do campo.
O exemplo de código a seguir mostra como acessar colunas da tabela marcada:
Mover para um marcador
Se precisar inserir conteúdo rico (não apenas texto simples) em um marcador, você deve usar MoveToBookmark para mover o cursor para o marcador e, em seguida, usar métodos e propriedades DocumentBuilder’s para inserir conteúdo.
Mostrar Ocultar Conteúdo dos Favoritos
Todo o marcador (incluindo o conteúdo marcado) pode ser encapsulado na parte True do campo IF usando Aspose.Words. Pode ser de forma que o campo IF contenha um Merge Field aninhado na expressão (Left of Operator) e dependendo do valor do Merge Field, o campo IF mostra ou oculta o conteúdo do Bookmark no Word Document.
O exemplo de código a seguir mostra como mostrar/ocultar marcadores: