Werken met paragrafen
Een alinea is een reeks tekens gecombineerd tot een logisch blok en eindigend met een speciaal teken – a paragraph break. In Aspose.Words wordt een alinea weergegeven door de Paragraph Klasse.
Een alinea invoegen
Als u een nieuwe alinea in het document wilt invoegen, moet u er in feite een alinea-breekkarakter in invoegen. DocumentBuilder.Writeln voegt niet alleen een tekenreeks in het document in, maar voegt ook een alinea-einde toe.
De huidige lettertypeopmaak wordt ook opgegeven door de Eigenschap Font en de huidige alineaopmaak wordt bepaald door de eigenschap ParagraphFormat. In de volgende sectie zullen we meer in detail ingaan op de opmaak van alinea ' s.
Het volgende codevoorbeeld laat zien hoe u een alinea invoegt in een document:
Alinea Opmaken
De huidige alineaopmaak wordt weergegeven door een ParagraphFormat object dat wordt geretourneerd door de Eigenschap ParagraphFormat. Dit object bevat verschillende eigenschappen voor alineaopmaak die beschikbaar zijn in Microsoft Word. U kunt de alineaopmaak eenvoudig terugzetten naar standaardstijl, links uitgelijnd geen inspringing, geen spatiëring, geen randen en geen schaduw door ClearFormatting aan te roepen.
Het volgende codevoorbeeld laat zien hoe u alineaopmaak instelt:
Alineastijl Toepassen
Sommige opmaakobjecten zoals lettertype of ParagraphFormat ondersteunen stijlen. Een enkele ingebouwde of door de gebruiker gedefinieerde stijl wordt weergegeven door een Style - object dat de overeenkomstige stijleigenschappen bevat, zoals naam, basisstijl, lettertype en alineaopmaak van de stijl, enzovoort.
Bovendien biedt een Style object de eigenschap StyleIdentifier die een locale-onafhankelijke stijlidentificatie retourneert die wordt weergegeven door de StyleIdentifier - opsommingswaarde. Het punt is dat de namen van ingebouwde stijlen in Microsoft Word gelokaliseerd zijn voor verschillende talen. Met behulp van een stijl-ID kunt u de juiste stijl vinden, ongeacht de taal van het document. De opsommingswaarden komen overeen met de Microsoft Word ingebouwde stijlen zoals Normal, Heading 1, Heading 2 enz. Alle door de gebruiker gedefinieerde stijlen krijgen de waarde StyleIdentifier.User toegewezen.
Het volgende codevoorbeeld laat zien hoe u een alineastijl toepast:
Stijlscheidingsteken invoegen om verschillende Alineastijlen toe te voegen
Het stijlscheidingsteken kan aan het einde van een alinea worden toegevoegd met de sneltoets Ctrl + Alt + Enter in MS Word. Deze functie maakt twee verschillende alineastijlen mogelijk die in één logische afgedrukte alinea worden gebruikt. Als u wilt dat sommige tekst van het begin van een bepaalde kop in een inhoudsopgave wordt weergegeven, maar niet de hele kop in de inhoudsopgave wilt, kunt u deze functie gebruiken.
Het volgende codevoorbeeld laat zien hoe u een stijlscheidingsteken invoegt om verschillende alineastijlen te accommoderen:
Alineastijlscheidingsteken Identificeren
Aspose.Words biedt een openbaar eigendom BreakIsStyleSeparator in een Paragraph klasse maakt het mogelijk om de paragraaf Stijlscheidingsteken te identificeren zoals in het onderstaande voorbeeld wordt getoond:
Randen en arcering toepassen op een alinea
Grenzen in Aspose.Words worden weergegeven door de BorderCollection Klasse – dit is een verzameling van Border objecten die toegankelijk zijn door index of door randtype. Het randtype wordt weergegeven door de BorderType - opsomming. Sommige waarden van de opsomming zijn van toepassing op meerdere of slechts één documentelement. BorderType.Bottom is bijvoorbeeld van toepassing op een alinea of tabelcel, terwijl BorderType.DiagonalDown alleen de diagonale Rand in een tabelcel specificeert.
Zowel de border collection als elke afzonderlijke border hebben vergelijkbare kenmerken zoals kleur, lijnstijl, lijnbreedte, afstand tot de tekst en optionele schaduw. Ze worden weergegeven door eigenschappen met dezelfde naam. U kunt verschillende randtypen bereiken door de eigenschapswaarden te combineren. Bovendien kunt u met zowel BorderCollection als Border objecten deze waarden terugzetten naar de standaardwaarde door de methode ClearFormatting aan te roepen.
Aspose.Words heeft ook de Shading klasse bevat schaduwattributen voor documentelementen. U kunt de gewenste schaduwtextuur instellen en de kleuren die op de achtergrond en voorgrond van het element worden toegepast.
De schaduwtextuur is ingesteld met een TextureIndex opsommingswaarde waarmee verschillende patronen op het Shading object kunnen worden toegepast. Als u bijvoorbeeld een achtergrondkleur voor een documentelement wilt instellen, gebruikt u de waarde TextureIndex.TextureSolid en stelt u de voorgrondkleur in.
Het volgende codevoorbeeld laat zien hoe u randen en arcering toepast op een alinea: