Visão Geral Do Document Builder
DocumentBuilder é uma classe poderosa que se associa a Document e permite criar documentos dinâmicos do zero ou adicionar novos elementos a um existente.
DocumentBuilder
Construtor de documentos ou Aspose.Words DOM
DocumentBuilder
Operações que são possíveis com DocumentBuilder também são possíveis ao usar as classes do Aspose.Words DOM diretamente. No entanto, usar classes Aspose.Words DOM diretamente geralmente requer mais linhas de código do que usar DocumentBuilder.
Navegação De Documentos
A navegação do documento baseia-se no conceito de cursor virtual, com o qual pode deslocar-se para outro local no documento utilizando vários métodos DocumentBuilder.MoveToXXX, tais como MoveToDocumentStart e MoveToField. Este cursor virtual indica onde o texto será inserido ao chamar os métodos Write, Writeln, InsertBreak, e outros. Consulte o seguinte artigo “navegação com Cursor” para saber mais sobre o cursor virtual.
O exemplo de código a seguir mostra como navegar para um marcador:
Construção e modificação de documentos
Aspose.Words API fornece várias classes que são responsáveis pela formatação de vários elementos de um documento. Cada uma das classes encapsula propriedades de formatação relacionadas a um elemento de documento específico, como texto, parágrafo, seção e outros. Por exemplo, a classe Font representa propriedades de formatação de caracteres, a classe ParagraphFormat representa propriedades de formatação de parágrafo e assim por diante. Os objetos dessas classes são retornados pelas propriedades DocumentBuilder correspondentes, que têm os mesmos nomes das classes. Portanto, você pode acessá-los e definir a formatação desejada durante a compilação do documento.
Você também pode inserir texto, checkbox, objeto ole, imagens, marcadores, campos de formulário e outros elementos de documento na posição do cursor usando o método Write ou qualquer um dos métodos DocumentBuilder.InsertXXX, como InsertField, InsertHtml e métodos semelhantes.
Vamos ver como criar um documento simples usando o DocumentBuilder.
Criar um documento utilizando DocumentBuilder
Para começar, você precisa criar um DocumentBuilder e associá-lo a um objeto Document. Você cria uma nova instância de DocumentBuilder chamando seu construtor e a passa para um objeto Document Para anexo ao construtor.
Para inserir um texto, passe a cadeia de texto que você precisa inserir no documento para o método Write.
O exemplo de código a seguir mostra como criar um documento simples usando um construtor de documentos.
Especificar A Formatação Do Documento
A propriedade Font define a formatação do texto. Este objeto contém diferentes atributos de fonte (Nome da fonte, tamanho da fonte, cor e assim por diante). Alguns atributos de fonte importantes também são representados por propriedades DocumentBuilder para permitir que você os acesse diretamente. Estas são as propriedades booleanas Font.Bold, Font.Italic e Font.Underline.
O exemplo de código a seguir mostra como inserir um texto formatado usando DocumentBuilder:
- Font especifica a formatação de caracteres que será aplicada a todo o texto inserido a partir da posição actual no documento.
- ParagraphFormat especifica a formatação do parágrafo para o atual e todos os parágrafos a serem inseridos.
- PageSetup especifica as propriedades da página e da secção para a secção actual e para toda a secção que será inserida.
- CellFormat e RowFormat especificam propriedades de formatação que serão aplicadas às células e linhas da tabela a partir da posição atual no documento.
Nesta situação," actual " significa a posição, parágrafo, secção, célula ou linha em que se encontra o cursor.