Exemplarische Vorgehensweise: Ändern der Dokumentformatierung mit CheckBox-Steuerelementen

Artikel
08/10/2011

In dieser exemplarischen Vorgehensweise wird die Verwendung von Windows Forms-Steuerelementen für die Änderung der Textformatierung in einer Anpassung auf Dokumentebene für Microsoft Office Word veranschaulicht.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

So fügen Sie dem Dokument in einem Projekt auf Dokumentebene zur Entwurfszeit einen Text und ein Steuerelement hinzu
Formatieren des Texts beim Auswählen einer Option

Das Ergebnis in einem vollständigen Beispiel finden Sie in dem Beispiel für Word-Steuerelemente unter Beispiele und exemplarische Vorgehensweisen für die Programmierung mit Office.

Tipp

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Eine Version von Visual Studio 2010, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.100\).md).

Word 2007 oder Word 2010

Erstellen des Projekts

Der erste Schritt besteht darin, ein Word-Dokumentprojekt zu erstellen.

So erstellen Sie ein neues Projekt

Erstellen Sie ein Word-Dokumentprojekt mit dem Namen Meine Word-Formatierung. Wählen Sie im Assistenten Neues Dokument erstellen aus.

Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Office-Projekten in Visual Studio.

Visual Studio öffnet das neue Word-Dokument im Designer und fügt dem Projektmappen-Explorer das Meine Word-Formatierung-Projekt hinzu.

Hinzufügen von Text und Steuerelementen zum Word-Dokument

Für diese exemplarische Vorgehensweise fügen Sie dem Word-Dokument drei Kontrollkästchen und etwas Text in einem Bookmark-Steuerelement hinzu. Die Kontrollkästchen bieten dem Benutzer Optionen zum Formatieren des Texts.

So fügen Sie drei Kontrollkästchen hinzu

Überprüfen Sie, ob das Dokument im Visual Studio-Designer geöffnet ist.
Ziehen Sie von der Registerkarte Allgemeine Steuerelemente der Toolbox das erste CheckBox-Steuerelement in das Dokument.
Ändern Sie im Eigenschaftenfenster die folgenden Eigenschaften.

Eigenschaft

Wert

Name

applyBoldFont

Text

Fett
Drücken Sie die EINGABETASTE, um die Einfügemarke unter das erste Kontrollkästchen zu bewegen.
Fügen Sie dem Dokument unterhalb des ApplyBoldFont-Kontrollkästchens ein zweites Kontrollkästchen hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

applyItalicFont

Text

Kursiv
Drücken Sie die EINGABETASTE, um die Einfügemarke unter das zweite Kontrollkästchen zu bewegen.
Fügen Sie dem Dokument unterhalb des ApplyItalicFont-Kontrollkästchens ein drittes Kontrollkästchen hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

applyUnderlineFont

Text

Unterstreichen

Eigenschaft	Wert
Name	applyBoldFont
Text	Fett

Eigenschaft	Wert
Name	applyItalicFont
Text	Kursiv

Eigenschaft	Wert
Name	applyUnderlineFont
Text	Unterstreichen

So fügen Sie Text und ein Bookmark-Steuerelement hinzu

Bewegen Sie die Einfügemarke unter die CheckBox-Steuerelemente, und geben Sie den folgenden Text ein:

Klicken Sie auf ein Kontrollkästchen, um die Formatierung des Texts zu ändern.
Ziehen Sie von der Registerkarte Word-Steuerelemente der Toolbox ein Bookmark-Steuerelement in das Dokument.

Das Dialogfeld Lesezeichen-Steuerelement hinzufügen wird angezeigt.
Wählen Sie den Text aus, den Sie dem Dokument hinzugefügt haben, und klicken Sie auf OK.

Dem ausgewählten Text wird im Dokument ein Bookmark-Steuerelement mit Namen Bookmark1 hinzugefügt.
Ändern Sie im Eigenschaftenfenster den Wert der (Name)-Eigenschaft in fontText**.**

Schreiben Sie dann den Code zum Formatieren des Texts beim Aktivieren oder Deaktivieren eines Kontrollkästchens.

Formatieren des Texts beim Aktivieren oder Deaktivieren eines Kontrollkästchens

Ändern Sie das Format des Texts im Dokument, wenn der Benutzer eine Formatierungsoption auswählt.

So ändern Sie die Formatierung beim Aktivieren eines Kontrollkästchens

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument, und klicken Sie anschließend im Kontextmenü auf Code anzeigen.
Fügen Sie der ThisDocument-Klasse die folgenden Konstanten hinzu (nur C#).
```
const int WordTrue = -1;
const int WordFalse = 0;
```

Fügen Sie dem Click-Ereignishandler des applyBoldFont-Kontrollkästchens den folgenden Code hinzu.

Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles applyBoldFont.Click

    Me.fontText.Bold = Me.applyBoldFont.Checked
End Sub

private void applyBoldFont_Click(object sender, System.EventArgs e)
{
    if (this.applyBoldFont.Checked == true)
    {
        this.fontText.Bold = WordTrue;
    }
    else
    {
        this.fontText.Bold = WordFalse;
    }
}

Fügen Sie dem Click-Ereignishandler des applyItalicFont-Kontrollkästchens den folgenden Code hinzu.

Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles applyItalicFont.Click

    Me.fontText.Italic = Me.applyItalicFont.Checked
End Sub

private void applyItalicFont_Click(object sender, System.EventArgs e)
{
    if (this.applyItalicFont.Checked == true)
    {
        this.fontText.Italic = WordTrue;
    }
    else
    {
        this.fontText.Italic = WordFalse;
    }
}

Fügen Sie dem Click-Ereignishandler des applyUnderlineFont-Kontrollkästchens den folgenden Code hinzu.

Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles applyUnderlineFont.Click

    If Me.applyUnderlineFont.Checked Then
        Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle
    Else
        Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone
    End If
End Sub

private void applyUnderlineFont_Click(object sender, System.EventArgs e)
{
    if (this.applyUnderlineFont.Checked == true)
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
    }
    else
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
    }
}

In C# müssen Sie Ereignishandler für die Textfelder zum Startup-Ereignis hinzufügen. Informationen zum Erstellen von Ereignishandlern finden Sie unter Gewusst wie: Erstellen von Ereignishandlern in Office-Projekten.

this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);

Testen der Anwendung

Sie können das Dokument nun testen, um zu überprüfen, ob der Text beim Aktivieren bzw. Deaktivieren eines Kontrollkästchens richtig formatiert wird.

So testen Sie das Dokument

Drücken Sie F5, um das Projekt auszuführen.
Aktivieren bzw. deaktivieren Sie ein Kontrollkästchen.
Überprüfen Sie, ob der Text richtig formatiert ist.

Nächste Schritte

In dieser exemplarischen Vorgehensweise werden die Grundlagen für die Verwendung von Kontrollkästchen sowie die programmgesteuerte Änderung der Textformatierung in Word-Dokumenten beschrieben. Die folgenden Aufgaben könnten sich daran anschließen: