Arbeiten mit Läufen

Artikel
09/24/2014

Letzte Änderung: Donnerstag, 13. Januar 2011

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

Inhalt dieses Artikels
Läufe in WordprocessingML
Run-Klasse
Beispiel

In diesem Thema wird die Open XML SDK 2.0-Klasse Run und ihre Beziehung zum Open XML-Dateiformatschema für WordprocessingML erläutert.

Läufe in WordprocessingML

Im folgenden Text aus der Spezifikation ISO/IEC 29500 wird das Open XML WordprocessingML-Laufelement eingeführt.

Die nächste Ebene der Dokumenthierarchie [nach dem Absatz] ist der Lauf ("run"), der einen Textbereich mit gemeinsamen Eigenschaften definiert. Ein Lauf wird durch ein r-Element dargestellt, in dem der Produzent Umbrüche, Formatvorlagen oder Formateigenschaften kombinieren und diese auf alle Teile des Laufs anwenden kann.

Ein Lauf kann ebenso wie ein Absatz Eigenschaften aufweisen. Die Eigenschaften aller Elemente in einem r-Element werden durch ein entsprechendes optionales rPr-Element ("run properties") gesteuert, welches das erste untergeordnete Element des r-Elements sein muss. Das rPr-Element ist wiederum ein Container für einen Satz von Eigenschaftenelementen, die auf die verbleibenden untergeordneten Elemente des r-Elements angewendet werden. Über die Elemente im rPr-Containerelement kann der Consumer steuern, ob der Text in den folgenden t-Elementen beispielsweise fett, unterstrichen oder sichtbar ist. Beispiele für Laufeigenschaften sind etwa Fett, Rahmen, Zeichenformatvorlage, Farbe, Schriftart, Schriftgrad, Kursiv, Kerning, Rechtschreib- und Grammatikprüfung deaktivieren, Schattierung, Kapitälchen, Durchgestrichen, Textrichtung und Unterstrichen.

In der folgenden Tabelle sind die Open XML SDK-Klassen aufgeführt, die beim Arbeiten mit Läufen am häufigsten verwendet werden.

XML-Element	Open XML SDK 2.0-Klasse
p	Paragraph
rPr	RunProperties
t	Text

Run-Klasse

Die OXML SDK-Klasse Run stellt das Laufelement (<r>) dar, das wie oben erläutert im Open XML-Dateiformatschema für WordprocessingML-Dokumente definiert ist. Verwenden Sie ein Run-Objekt, um ein einzelnes <r>-Element in einem WordprocessingML-Dokument zu bearbeiten.

RunProperties-Klasse

In WordprocessingML werden die Eigenschaften für ein Laufelement mithilfe eines Laufeigenschaftenelements (<rPr>) angegeben. Beispiele für Laufeigenschaften sind etwa Fett, Rahmen, Zeichenformatvorlage, Farbe, Schriftart, Schriftgrad, Kursiv, Kerning, Rechtschreib- und Grammatikprüfung deaktivieren, Schattierung, Kapitälchen, Durchgestrichen, Textrichtung und Unterstrichen. Verwenden Sie ein RunProperties-Objekt, um die Eigenschaften für einen Lauf in einem WordprocessingML-Dokument festzulegen.

Text-Objekt

Zusammen mit dem <r>-Element stellt das Textelement (<t>) den Container für den Text dar, aus dem der Dokumentinhalt besteht. Die OXML SDK-Klasse Text stellt das <t>-Element dar. Verwenden Sie ein Text-Objekt, um Text in einem Wordprocessing-Dokument zu platzieren.

Beispiel

Vom folgenden Code wird Text zur Hauptdokumentoberfläche des angegebenen WordprocessingML-Dokuments hinzugefügt. Ein Run-Objekt markiert einen Textbereich in dem Absatz. Anschließend wird ein RunProperties-Objekt verwendet, um Fettformat auf den Lauf anzuwenden.

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 new text.
        Paragraph para = body.AppendChild(new Paragraph());
        Run run = para.AppendChild(new Run());

        // Apply bold formatting to the run.
        RunProperties runProperties = run.AppendChild(new RunProperties(new Bold()));   
        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 new text.
        Dim para As Paragraph = body.AppendChild(New Paragraph())
        Dim run As Run = para.AppendChild(New Run())

        ' Apply bold formatting to the run.
        Dim runProperties As RunProperties = run.AppendChild(New RunProperties(New Bold()))
        run.AppendChild(New Text(txt))
    End Using
End Sub

Bei Ausführung des Codes wird folgende XML in das im vorherigen Code angegebene WordprocessingML-Dokument geschrieben.

<w:p>
  <w:r>
    <w:rPr>
      <w:b />
    </w:rPr>
    <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 Absätzen

Anleitung: Anwenden eines Formats auf einen Absatz in einem Textverarbeitungsdokument

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

Freigeben über