--- title: "Trabalhar com parágrafos em Java" --- Um parágrafo é um conjunto de caracteres combinados em um bloco lógico e terminando com um caractere especial - a *paragraph break*. Em Aspose.Words, um parágrafo é representado pela classe [Paragraph](https://reference.aspose.com/words/java/com.aspose.words/paragraph/). ## Inserir um parágrafo Para inserir um novo parágrafo no documento, na verdade, você precisa inserir um caractere de quebra de parágrafo nele. [DocumentBuilder.Writeln](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#writeln) insere não apenas uma sequência de texto no documento, mas também adiciona uma quebra de parágrafo. A formatação de fonte atual também é especificada pela propriedade [Font](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#getFont) e a formatação de parágrafo atual é determinada pela propriedade [ParagraphFormat](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#getParagraphFormat). Na próxima seção, entraremos em mais detalhes sobre a formatação de parágrafos. O exemplo de código a seguir mostra como inserir um parágrafo em um documento: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-WorkingWithParagraphs-DocumentBuilderInsertParagraph.java" >}} ## Formato Do Parágrafo A formatação de parágrafo atual é representada pelo objeto [ParagraphFormat](https://reference.aspose.com/words/java/com.aspose.words/paragraphformat/) que é retornado pela propriedade [ParagraphFormat](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#getParagraphFormat). Este objeto encapsula várias propriedades de formatação de parágrafo disponíveis em Microsoft Word. Você pode facilmente redefinir a formatação de um parágrafo para seu padrão-Estilo Normal, alinhado à esquerda, sem recuo, sem espaçamento, sem bordas, sem sombreamento-chamando [ClearFormatting](https://reference.aspose.com/words/java/com.aspose.words/paragraphformat/#clearFormatting). O exemplo de código a seguir mostra como definir a formatação do parágrafo: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-WorkingWithParagraphs-DocumentBuilderSetParagraphFormatting.java" >}} ## Aplicar O Estilo Do Parágrafo Alguns objetos de formatação, como Font ou ParagraphFormat, suportam estilos. Um único estilo interno ou definido pelo Usuário é representado por um objeto [Style](https://reference.aspose.com/words/java/com.aspose.words/style/) que contém as propriedades de estilo correspondentes, como nome, Estilo base, fonte e formatação de parágrafo do estilo, e assim por diante. Além disso, um objeto **Style** fornece a propriedade [StyleIdentifier](https://reference.aspose.com/words/java/com.aspose.words/style/#getStyleIdentifier) que retorna um identificador de estilo independente de localidade representado por um valor de enumeração **StyleIdentifier**. A questão é que os nomes dos estilos incorporados em Microsoft Word estão localizados para diferentes idiomas. Usando um identificador de estilo, você pode encontrar o estilo correto, independentemente do idioma do documento. Os valores de enumeração correspondem aos estilos incorporados Microsoft Word, tais como *Normal*, *Heading 1*, *Heading 2*, etc. Todos os estilos definidos pelo Utilizador são atribuídos a **StyleIdentifier.User value**. O exemplo de código a seguir mostra como aplicar um estilo de parágrafo: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-WorkingWithParagraphs-DocumentBuilderApplyParagraphStyle.java" >}} ## Inserir Separador de estilo para colocar diferentes estilos de parágrafo O separador de estilos pode ser adicionado ao final de um parágrafo utilizando o atalho de teclado Ctrl + Alt + Enter na palavra MS. Este recurso permite dois estilos de parágrafo diferentes usados em um parágrafo impresso lógico. Se pretender que algum texto do início de um título específico apareça num Sumário, mas não pretender que o título inteiro no sumário, pode utilizar esta funcionalidade. O exemplo de código a seguir mostra como inserir um separador de estilo para acomodar diferentes estilos de parágrafo: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-WorkingWithParagraphs-ParagraphInsertStyleSeparator.java" >}} ## Aplicar bordas e sombreamento a um parágrafo As bordas em Aspose.Words são representadas pela classe [BorderCollection](https://reference.aspose.com/words/java/com.aspose.words/bordercollection/) - esta é uma coleção de objetos [Border](https://reference.aspose.com/words/java/com.aspose.words/border/) que são acessados por índice ou por tipo de borda. O tipo `Border` é representado pela enumeração [BorderType](https://reference.aspose.com/words/java/com.aspose.words/bordertype/). Alguns valores da enumeração são aplicáveis a vários ou apenas a um elemento do documento. Por exemplo, **BorderType.Bottom** é aplicável a um parágrafo ou célula de tabela, enquanto **BorderType.DiagonalDown** especifica a borda diagonal apenas em uma célula de tabela. Tanto a coleção de bordas quanto cada borda separada têm atributos semelhantes, como cor, estilo de linha, largura da linha, distância do texto e sombra opcional. Eles são representados por propriedades com o mesmo nome. Você pode obter diferentes tipos de borda combinando os valores da propriedade. Além disso, os objetos **BorderCollection** e **Border** permitem redefinir esses valores para o padrão chamando o método [ClearFormatting](https://reference.aspose.com/words/java/com.aspose.words/border/#clearFormatting). ``` Observe que quando as propriedades da borda são redefinidas para os valores padrão, a borda fica invisível. ``` Aspose.Words também tem a classe [Shading](https://reference.aspose.com/words/java/com.aspose.words/shading/) contém atributos de sombreamento para elementos de Documento. Você pode definir a textura de sombreamento desejada e as cores aplicadas ao plano de fundo e ao primeiro plano do elemento. A textura de sombreamento é definida com o valor de enumeração [TextureIndex](https://reference.aspose.com/words/java/com.aspose.words/textureindex/) que permite a aplicação de vários padrões ao objeto **Shading**. Por exemplo, para definir uma cor de fundo para um elemento de Documento, use o valor `TextureIndex.TextureSolid` e defina a cor de sombreamento de primeiro plano conforme apropriado. O exemplo de código dado abaixo mostra como aplicar bordas e sombreamento a um parágrafo. O exemplo de código a seguir mostra como aplicar bordas e sombreamento a um parágrafo: {{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-document-WorkingWithParagraphs-DocumentBuilderApplyBordersAndShadingToParagraph.java" >}}