[C#/VB.NET] Hintergrundfarbe von Absätzen und Text in Word-Dokumenten festlegen
Tags: csharp, vbnet, dotnet, word
Published: 2023-08-18 09:53:05

In Word-Dokumenten sind Absatz- und Text-Hintergrundfarben wichtige Designelemente. Passende Hintergrundfarben für Absätze und Text können nicht nur bestimmte Absätze und Text hervorheben, den Textkontrast erhöhen und die Lesbarkeit verbessern, sondern auch helfen, Layout-Leerräume auszufüllen.

In diesem Artikel wird erklärt, wie Sie mit der kostenlosen [Free Spire.Doc für .NET](https://www.e-iceblue.com/Introduce/free-doc-component.html)-Programmierung die Hintergrundfarbe von Absätzen und Text festlegen.

- **[Hintergrundfarbe von Absätzen in Word-Dokumenten festlegen](#hintergrundfarbe-von-abs%C3%A4tzen-in-worddokumenten-festlegen)**
- **[Hintergrundfarbe von Text in Word-Dokumenten festlegen](#hintergrundfarbe-von-text-in-worddokumenten-festlegen)**

### Abhängigkeit hinzufügen

Die Abhängigkeit von Free Spire.Doc für .NET kann manuell von der [offiziellen Website](https://www.e-iceblue.com/Download/download-word-for-net-free.html) heruntergeladen, über den NuGet-Paketmanager gesucht oder über die Paket-Manager-Konsole mit folgendem Code hinzugefügt werden:

```xml
PM> Install-Package FreeSpire.Doc
```

## Hintergrundfarbe von Absätzen in Word-Dokumenten festlegen

Um die Hintergrundfarbe eines Absatzes festzulegen, rufen Sie zuerst den gewünschten Absatz ab und legen Sie die Hintergrundfarbe mit der **Paragraph.Format.BackColor**-Eigenschaft fest. Die konkreten Schritte sind:

- Erstellen Sie ein **Document**-Klassenobjekt.
- Laden Sie das Word-Dokument mit der **LoadFromFile()**-Methode.
- Rufen Sie den ersten Abschnitt des Dokuments mit der **Sections[]**-Eigenschaft ab.
- Rufen Sie den vierten Absatz dieses Abschnitts mit der **Paragraphs[]**-Eigenschaft ab.
- Legen Sie die Hintergrundfarbe dieses Absatzes mit der **Paragraph.Format.BackColor**-Eigenschaft fest.
- Speichern Sie das Dokument mit der **SaveToFile()**-Methode.

**Codebeispiel**

**C#:**

```c#
using System;
using Spire.Doc; 
using Spire.Doc.Documents;
using System.Drawing;

namespace SetParagraphBackgroundColor
{
  class Program
  {
    static void Main(string[] args)
    {
      // Erstellen eines Document-Objekts
      Document document = new Document();

      // Word-Dokument laden
      document.LoadFromFile("Beispiel.docx");

      // Ersten Abschnitt des Dokuments abrufen
      Section section = document.Sections[0];

      // Vierten Absatz dieses Abschnitts abrufen
      Paragraph paragraph = section.Paragraphs[3];

      // Hintergrundfarbe dieses Absatzes auf Hellgrau setzen
      paragraph.Format.BackColor = Color.LightGray;

      // Dokument speichern  
      document.SaveToFile("Absatz-Hintergrundfarbe.docx", FileFormat.Docx_2013);

      // Ressourcen freigeben
      document.Dispose();

      Console.WriteLine("Hintergrundfarbe für Absatz festgelegt"); 
      Console.ReadLine();
    }
  }
}
```

**VB.NET:**

```vb
Imports System
Imports Spire.Doc
Imports Spire.Doc.Documents
Imports System.Drawing

Namespace SetParagraphBackgroundColor
  Class Program
    Shared Sub Main(ByVal args() As String)
      ' Erstellen eines Document-Objekts
      Dim document As New Document()

      ' Word-Dokument laden
      document.LoadFromFile("Beispiel.docx")

      ' Ersten Abschnitt des Dokuments abrufen
      Dim section As Section = document.Sections(0)

      ' Vierten Absatz dieses Abschnitts abrufen
      Dim paragraph As Paragraph = section.Paragraphs(3)

      ' Hintergrundfarbe dieses Absatzes auf Hellgrau setzen
      paragraph.Format.BackColor = Color.LightGray

      ' Dokument speichern
      document.SaveToFile("Absatz-Hintergrundfarbe.docx", FileFormat.Docx_2013)

      ' Ressourcen freigeben
      document.Dispose()

      Console.WriteLine("Hintergrundfarbe für Absatz festgelegt")
      Console.ReadLine()
    End Sub
  End Class
End Namespace
```


![Hintergrundfarbe von Absätzen in Word-Dokumenten festlegen](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/61nhj379u6l623dl5m6a.png)

## Hintergrundfarbe von Text in Word-Dokumenten festlegen

Free Spire.Doc für Java bietet die **Document.FindAllString()**-Methode, um alle Vorkommen eines bestimmten Textes im Word-Dokument zu finden, und die **TextRange.CharacterFormat.TextBackgroundColor**-Eigenschaft, um die Hintergrundfarbe von Text festzulegen. Die detaillierten Schritte zum Festlegen der Hintergrundfarbe von vorhandenem Text sind:

- Erstellen Sie ein **Document**-Klassenobjekt.
- Laden Sie das Word-Dokument mit der **LoadFromFile()**-Methode.
- Suchen Sie nach "Zuckerkonsum" mit der **FindAllString()**-Methode und rufen Sie alle Ergebnisse ab.
- Durchlaufen Sie alle Ergebnisse in einer Schleife.
- Rufen Sie die Suchergebnisse als Textbereich mit der **GetAsOneRange()**-Methode ab.
- Legen Sie die Hintergrundfarbe des Textbereichs mit der **TextRange.CharacterFormat.TextBackgroundColor**-Eigenschaft fest.
- Speichern Sie das Dokument mit der **SaveToFile()**-Methode.

**Codebeispiel**

**C#:**

```C#
using System;
using Spire.Doc;
using Spire.Doc.Documents; 
using System.Drawing;

namespace SetTextBackgroundColor 
{
  class Program
  {
    static void Main(string[] args)
    {
      // Erstellen eines Document-Objekts
      Document document = new Document();

      // Word-Dokument laden  
      document.LoadFromFile("Beispiel.docx");

      // Zu formatierenden Text suchen
      TextSelection[] textSelections = document.FindAllString("Zuckerkonsum", false, true);

      // Durch Ergebnisse iterieren
      foreach (TextSelection selection in textSelections)
      {
        // Textbereich abrufen
        TextRange textRange = selection.GetAsOneRange();
      
        // Hintergrundfarbe festlegen
        textRange.CharacterFormat.TextBackgroundColor = Color.Cyan;  
      }

      // Dokument speichern
      document.SaveToFile("Text-Hintergrundfarbe.docx", FileFormat.Docx_2013);

      // Ressourcen freigeben
      document.Dispose();
      
      Console.WriteLine("Text-Hintergrundfarbe festgelegt");
      Console.ReadLine();
    }
  }
}
```

**VB.NET:**

```vb
Imports System
Imports Spire.Doc
Imports Spire.Doc.Documents
Imports System.Drawing

Namespace SetTextBackgroundColor
  Class Program
    Shared Sub Main(ByVal args() As String)
      ' Erstellen eines Document-Objekts
      Dim document As New Document()

      ' Word-Dokument laden
      document.LoadFromFile("Beispiel.docx")

      ' Zu formatierenden Text suchen  
      Dim textSelections As TextSelection() = document.FindAllString("Zuckerkonsum", False, True)

      ' Durch Ergebnisse iterieren
      For Each selection As TextSelection In textSelections
        ' Textbereich abrufen
        Dim textRange As TextRange = selection.GetAsOneRange()

        ' Hintergrundfarbe festlegen
        textRange.CharacterFormat.TextBackgroundColor = Color.Cyan
      Next

      ' Dokument speichern
      document.SaveToFile("Text-Hintergrundfarbe.docx", FileFormat.Docx_2013)

      ' Ressourcen freigeben
      document.Dispose()

      Console.WriteLine("Text-Hintergrundfarbe festgelegt")
      Console.ReadLine()
    End Sub
  End Class
End Namespace
```


![Hintergrundfarbe von Text in Word-Dokumenten festlegen](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ic3hnmo11k6t3g0o2ryr.png)

> In diesem Artikel haben wir gezeigt, wie man in Word-Dokumenten die Hintergrundfarbe von Absätzen und Text mit Free Spire.Doc für Java festlegt. Die API bietet viele weitere Funktionen zur Word-Dokumentenverarbeitung. Schauen Sie in die [Spire.Doc für Java-Tutorials](https://www.e-iceblue.com/Tutorials/Spire.Doc/Spire.Doc-Program-Guide/Spire.Doc-Program-Guide-Content.html) für weitere Informationen. Wenn Sie Probleme mit dieser API haben oder mit anderen darüber diskutieren möchten, besuchen Sie bitte das [Spire.Doc Forum](https://www.e-iceblue.com/forum/spire-doc-f6.html?sid=417b18c80c31eb243fa9849a0612d48b).