[C#/VB.NET] Hintergrundfarbe von Absätzen und Text in Word-Dokumenten festlegen

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-Programmierung die Hintergrundfarbe von Absätzen und Text festlegen.

• Hintergrundfarbe von Absätzen in Word-Dokumenten festlegen
• Hintergrundfarbe von Text in Word-Dokumenten festlegen

Abhängigkeit hinzufügen

Die Abhängigkeit von Free Spire.Doc für .NET kann manuell von der offiziellen Website heruntergeladen, über den NuGet-Paketmanager gesucht oder über die Paket-Manager-Konsole mit folgendem Code hinzugefügt werden:

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#:

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:

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 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#:

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:

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

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 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.