Arbeiten mit Absätzen

Artikel
09/24/2014

Letzte Änderung: Donnerstag, 13. Januar 2011

Gilt für: Excel 2010 | Office 2010 | PowerPoint 2010 | Word 2010

Inhalt dieses Artikels
Absätze in WordprocessingML
Paragraph-Klasse
Beispiel

In diesem Thema werden die Open XML SDK 2.0Paragraph-Klasse und ihre Beziehungen zum WordprocessingML-Schema des Open XML-Dateiformats behandelt.

Absätze in WordprocessingML

Der folgende Text aus der Spezifikation ISO/IEC 29500 enthält eine Einführung in das Open XML WordprocessingML-Element, das zum Darstellen eines Absatzes in einem WordprocessingML-Dokument dient.

Die einfachste Einheit von Inhalten auf Blockebene in einem WordprocessingML-Dokument (Absätze) werden mithilfe des Elements <p> gespeichert. Ein Absatz bestimmt eine erkennbare Aufteilung des Inhalts, der in einer neuen Zeile beginnt. Ein Absatz kann drei Informationen enthalten: optionale Absatzeigenschaften, Inlineinhalte (zumeist Läufe) und eine Gruppe optionaler Überarbeitungs-IDs, die zum Vergleichen des Inhalts zweier Dokumente dienen.

Die Eigenschaften eines Absatzes werden mithilfe des Elements <pPr> angegeben. Beispiele für Absatzeigenschaften sind Ausrichtung, Rand, Deaktivieren der Silbentrennung, Einrückung, Zeilenabstand, Schattierung, Textrichtung und Absatzkontrolle.

In der folgenden Tabelle sind die allgemeinen Open XML SDK-Klassen aufgeführt, die beim Arbeiten mit Absätzen verwendet werden.

WordprocessingML-Element	Open XML SDK 2.0-Klasse
p	Paragraph
pPr	ParagraphProperties
r	Run
t	Text

Paragraph-Klasse

Die OXML SDK-Klasse Paragraph stellt das Absatzelement (<p>) dar, das im Open XML-Dateiformatschema für oben genannte WordprocessingML-Dokumente definiert ist. Mithilfe des Paragraph-Objekts können Sie einzelne <p>-Elemente in einem WordprocessingML-Dokument bearbeiten.

ParagraphProperties-Klasse

In WordprocessingML werden die Eigenschaften eines Absatzes mithilfe des Elements (<pPr>) angegeben. Beispiele für Absatzeigenschaften sind Ausrichtung, Rand, Deaktivieren der Silbentrennung, Einrückung, Zeilenabstand, Schattierung, Textrichtung und Absatzkontrolle. Die OXML SDK-Klasse ParagraphPropertiesstellt das <pPr>-Element dar.

Run-Klasse

Absätze in einem Textverarbeitungsdokument enthalten zumeist Text. Im Open XML-Dateiformatschema für WordprocessingML-Dokumenten dient das Element <r (für "Run", dt. Lauf) zum Abgrenzen von Textbereichen. Die Open XML SDK-Klasse Run stellt das <r>-Element dar.

Text-Objekt

Beim Element <r> ist das Textelement (<t>) der Container des Texts, der den Dokumentinhalt bildet. Die Open XML SDK-Klasse Text stellt das Element <t> dar.

Beispiel

Der folgende Code instanziiert ein Open XML SDK 2.0-Objekt vom Typ Paragraph, mit dessen Hilfe dem WordprocessingML-Dokument anschließend Text hinzugefügt wird.

public static void WriteToWordDoc(string filepath, string txt)
{
    // Open a WordprocessingDocument for editing using the filepath.
    using (WordprocessingDocument wordprocessingDocument =
         WordprocessingDocument.Open(filepath, true))
    {
        // Assign a reference to the existing document body.
        Body body = wordprocessingDocument.MainDocumentPart.Document.Body;

        // Add a paragraph with some text.
        Paragraph para = body.AppendChild(new Paragraph());
        Run run = para.AppendChild(new Run());
        run.AppendChild(new Text(txt));
    }
}

Public Sub WriteToWordDoc(ByVal filepath As String, ByVal txt As String)
    ' Open a WordprocessingDocument for editing using the filepath.
    Using wordprocessingDocument As WordprocessingDocument = _
        WordprocessingDocument.Open(filepath, True)
        ' Assign a reference to the existing document body.
        Dim body As Body = wordprocessingDocument.MainDocumentPart.Document.Body

        ' Add a paragraph with some text.            
        Dim para As Paragraph = body.AppendChild(New Paragraph())
        Dim run As Run = para.AppendChild(New Run())
        run.AppendChild(New Text(txt))
    End Using

End Sub

Bei Ausführung dieses Codes wird der folgende XML-Code in das WordprocessingML-Dokument geschrieben, auf das im Code verwiesen wird.

<w:p>
  <w:r>
    <w:t>String from WriteToWordDoc method.</w:t>
  </w:r>
</w:p>

Siehe auch

Konzepte

Informationen zum Open XML SDK 2.0 für Microsoft Office

Arbeiten mit Läufen

Anleitung: Anwenden eines Formats auf einen Absatz in einem Textverarbeitungsdokument

Anleitung: Öffnen eines Textverarbeitungsdokuments und Hinzufügen von Text

Freigeben über