Arbeiten mit Absätzen
Ein Absatz ist eine Reihe von Zeichen, die zu einem logischen Block zusammengefasst sind und mit einem Sonderzeichen – einem Absatzumbruch – enden. In Aspose.Words wird ein Absatz durch die Paragraph-Klasse dargestellt.
Fügen Sie einen Absatz ein
Um einen neuen Absatz in das Dokument einzufügen, müssen Sie tatsächlich ein Absatzumbruchzeichen einfügen. DocumentBuilder.writeln fügt ebenfalls eine Textzeichenfolge in das Dokument ein, fügt jedoch zusätzlich einen Absatzumbruch ein.
Die aktuelle Schriftartformatierung wird ebenfalls durch die font-Eigenschaft angegeben und die aktuelle Absatzformatierung wird durch die paragraph_format-Eigenschaft bestimmt.
Das folgende Codebeispiel zeigt, wie man einen Absatz in ein Dokument einfügt:
Absatz formatieren
Die aktuelle Absatzformatierung wird durch ein ParagraphFormat-Objekt dargestellt, das von der paragraph_format-Eigenschaft zurückgegeben wird. Dieses Objekt kapselt verschiedene in Microsoft Word verfügbare Absatzformatierungseigenschaften. Sie können die Absatzformatierung ganz einfach auf die Standardeinstellung “Normaler Stil, linksbündig, ohne Einrückung, ohne Abstand, ohne Rahmen und ohne Schattierung” zurücksetzen, indem Sie clear_formatting aufrufen.
Das folgende Codebeispiel zeigt, wie Sie die Absatzformatierung festlegen:
Wenden Sie einen Absatzstil an
Einige Formatierungsobjekte wie Font 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 Style.style_identifier-Eigenschaft bereit, die eine vom Gebietsschema unabhängige Stilkennung zurückgibt, die durch einen StyleIdentifier-Enumerationswert 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 in Microsoft Word integrierten Stilen wie “Normal”, “Überschrift 1”, “Überschrift 2” usw. Allen benutzerdefinierten Stilen wird der StyleIdentifier.USER-Wert zugewiesen
Das folgende Codebeispiel zeigt, wie ein Absatzstil angewendet wird:
Fügen Sie ein Stiltrennzeichen ein, um verschiedene Absatzstile einzufügen
Mit der Tastenkombination Strg + Alt + Eingabetaste in MS Word kann am Ende eines Absatzes ein Stiltrennzeichen hinzugefügt werden. Diese Funktion ermöglicht die Verwendung zweier verschiedener Absatzstile in einem logisch gedruckten Absatz. Wenn Sie möchten, dass ein Teil des Textes vom Anfang einer bestimmten Überschrift in einem Inhaltsverzeichnis angezeigt wird, aber nicht die gesamte Überschrift im Inhaltsverzeichnis angezeigt wird, können Sie diese Funktion verwenden
Das folgende Codebeispiel zeigt, wie ein Stiltrennzeichen eingefügt wird, um verschiedene Absatzstile zu berücksichtigen:
Identifizieren Sie das Trennzeichen für den Absatzstil
Aspose.Words stellt eine öffentliche Eigenschaft break_is_style_separator in einer Paragraph-Klasse bereit und ermöglicht die Identifizierung von Stiltrennzeichenabsätzen, wie im folgenden Beispiel gezeigt:
Wenden Sie Rahmen und Schattierungen auf einen Absatz an
Grenzen werden durch das BorderCollection dargestellt. Dies ist eine Sammlung von Border-Objekten, auf die über Index oder Rahmentyp zugegriffen wird. Der Rahmentyp wird durch die BorderType-Enumeration dargestellt. Einige Werte der Aufzählung gelten für mehrere oder nur ein Dokumentelement. BorderType.BOTTOM ist beispielsweise auf einen Absatz oder eine Tabellenzelle anwendbar, während BorderType.DIAGONALDOWN nur den diagonalen Rand in einer Tabellenzelle angibt.
Sowohl die Rahmensammlung als auch jeder einzelne Rahmen verfügen über ähnliche Attribute wie Farbe, Linienstil, Linienstärke, Abstand vom Text und optionaler Schatten. Sie werden durch gleichnamige Eigenschaften dargestellt. Durch die Kombination der Eigenschaftswerte können Sie unterschiedliche Rahmentypen erzielen. Darüber hinaus ermöglichen Ihnen sowohl BorderCollection- als auch Border-Objekte, diese Werte durch Aufrufen der Border.clear_formatting-Methode auf die Standardwerte zurückzusetzen.
Aspose.Words verfügt außerdem über die Shading-Klasse, die Schattierungsattribute für Dokumentelemente enthält. Sie können die gewünschte Schattierungstextur und die Farben festlegen, die auf den Hintergrund und den Vordergrund des Elements angewendet werden.
Die Schattierungstextur wird mit einem TextureIndex-Enumerationswert festgelegt, der die Anwendung verschiedener Muster auf das Shading-Objekt ermöglicht. Um beispielsweise eine Hintergrundfarbe für ein Dokumentelement festzulegen, verwenden Sie den TextureIndex.TEXTURE_SOLID-Wert und legen Sie die Vordergrundschattierungsfarbe entsprechend fest. Das folgende Beispiel zeigt, wie Sie Rahmen und Schattierungen auf einen Absatz anwenden.
Das folgende Codebeispiel zeigt, wie Rahmen und Schattierungen auf einen Absatz angewendet werden: