Arbeiten mit Absätzen
Ein Absatz ist eine Reihe von Zeichen, die zu einem logischen Block zusammengefasst sind und mit einem Sonderzeichen enden – a paragraph break. In Aspose.Words wird ein Absatz durch die Klasse Paragraph dargestellt.
Einen Absatz einfügen
Um einen neuen Absatz in das Dokument einzufügen, müssen Sie tatsächlich ein Absatzumbruchzeichen einfügen. DocumentBuilder.Writeln fügt nicht nur eine Textzeichenfolge in das Dokument ein, sondern fügt auch einen Absatzumbruch hinzu.
Die aktuelle Schriftformatierung wird auch durch die Eigenschaft Font angegeben, und die aktuelle Absatzformatierung wird durch die Eigenschaft ParagraphFormat bestimmt. Im nächsten Abschnitt werden wir näher auf die Absatzformatierung eingehen.
Das folgende Codebeispiel zeigt, wie Sie einen Absatz in ein Dokument einfügen:
Absatz formatieren
Die aktuelle Absatzformatierung wird durch ein ParagraphFormat-Objekt dargestellt, das von der Eigenschaft ParagraphFormat zurückgegeben wird. Dieses Objekt kapselt verschiedene Absatzformatierungseigenschaften ein, die in Microsoft Word verfügbar sind. Sie können die Absatzformatierung einfach auf den Standardstil Normaler Stil, linksbündig, kein Einzug, kein Abstand, keine Ränder und keine Schattierung zurücksetzen, indem Sie ClearFormatting aufrufen.
Das folgende Codebeispiel zeigt, wie Sie die Absatzformatierung festlegen:
Absatzvorlage anwenden
Einige Formatierungsobjekte wie Schriftart oder ParagraphFormat unterstützen Stile. Ein einzelner integrierter oder benutzerdefinierter Stil wird durch ein Style-Objekt dargestellt, das die entsprechenden Stileigenschaften wie Name, Basisstil, Schriftart und Absatzformatierung des Stils usw. enthält.
Darüber hinaus stellt ein Style-Objekt die StyleIdentifier-Eigenschaft bereit, die eine gebietsschemaunabhängige Stilkennung zurückgibt, die durch den StyleIdentifier-Aufzählungswert dargestellt wird. Der Punkt ist, dass die Namen der integrierten Stile in Microsoft Word für verschiedene Sprachen lokalisiert sind. Mithilfe einer Stilkennung können Sie unabhängig von der Dokumentsprache den richtigen Stil finden. Die Aufzählungswerte entsprechen den integrierten Microsoft Word-Stilen wie z Normal, Heading 1, Heading 2 usw. Allen benutzerdefinierten Stilen wird der Wert StyleIdentifier.User zugewiesen.
Das folgende Codebeispiel zeigt, wie Sie ein Absatzformat anwenden:
Stiltrennzeichen einfügen, um verschiedene Absatzstile einzufügen
Das Stiltrennzeichen kann am Ende eines Absatzes mit der Tastenkombination Strg + Alt + Eingabetaste in das Wort MS eingefügt werden. Diese Funktion ermöglicht zwei verschiedene Absatzformate, die in einem logisch gedruckten Absatz verwendet werden. Wenn Sie möchten, dass Text vom Anfang einer bestimmten Überschrift in einem Inhaltsverzeichnis angezeigt wird, aber nicht die gesamte Überschrift im Inhaltsverzeichnis, können Sie diese Funktion verwenden.
Das folgende Codebeispiel zeigt, wie Sie ein Stiltrennzeichen einfügen, um verschiedene Absatzstile aufzunehmen:
Absatzformattrennzeichen identifizieren
Aspose.Words stellt eine öffentliche Eigenschaft BreakIsStyleSeparator in einer Paragraph -Klasse bereit, mit der Stiltrennzeichen identifiziert werden können Absatz wie im folgenden Beispiel gezeigt:
Anwenden von Rahmen und Schattierungen auf einen Absatz
Rahmen in Aspose.Words werden durch die BorderCollection -Klasse dargestellt - dies ist eine Sammlung von Border -Objekten, auf die über den Index oder den Rahmentyp zugegriffen wird. Der Rahmentyp wird durch die BorderType-Aufzählung dargestellt. Einige Werte der Aufzählung sind auf mehrere oder nur ein Dokumentelement anwendbar. Beispielsweise gilt BorderType.Bottom für eine Absatz- oder Tabellenzelle, während BorderType.DiagonalDown nur den diagonalen Rand in einer Tabellenzelle angibt.
Sowohl die Rahmensammlung als auch jeder einzelne Rahmen haben ähnliche Attribute wie Farbe, Linienstil, Linienbreite, Abstand zum Text und optionaler Schatten. Sie werden durch gleichnamige Eigenschaften dargestellt. Sie können verschiedene Rahmentypen erzielen, indem Sie die Eigenschaftswerte kombinieren. Darüber hinaus können Sie mit BorderCollection - und Border -Objekten diese Werte durch Aufrufen der ClearFormatting-Methode auf die Standardwerte zurücksetzen.
Aspose.Words hat auch die Shading -Klasse, die Schattierungsattribute für Dokumentelemente enthält. Sie können die gewünschte Schattierungstextur und die Farben einstellen, die auf den Hintergrund und den Vordergrund des Elements angewendet werden.
Die Schattierungstextur wird mit einem TextureIndex-Aufzählungswert festgelegt, der die Anwendung verschiedener Muster auf das Shading-Objekt ermöglicht. Um beispielsweise eine Hintergrundfarbe für ein Dokumentelement festzulegen, verwenden Sie den Wert TextureIndex.TextureSolid und legen Sie die Vordergrundschattierungsfarbe entsprechend fest.
Das folgende Codebeispiel zeigt, wie Rahmen und Schattierungen auf einen Absatz angewendet werden: