Exemplarische Vorgehensweise: Ändern der Dokumentformatierung mit CheckBox-Steuerelementen

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Microsoft Office-Version Word 2007 Word 2003 Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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.

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 als vollständiges Beispiel finden Sie unter Beispiel für Word-Steuerelemente.

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

• Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).

• Microsoft Office Word 2003 oder Microsoft Office Word 2007

Visual Studio Tools for Office wird standardmäßig mit den aufgeführten Versionen von Visual Studio installiert. Wie Sie überprüfen können, ob die Software installiert ist, erfahren Sie in Installieren von Visual Studio Tools for Office.

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 Visual Studio Tools for Office-Projekte.

  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

1. Überprüfen Sie, ob das Dokument im Visual Studio-Designer geöffnet ist.

2. Ziehen Sie von der Registerkarte Allgemeine Steuerelemente der Toolbox das erste CheckBox-Steuerelement in das Dokument.

3. Ändern Sie im Eigenschaftenfenster die folgenden Eigenschaften.

   Property	Value
   Name	applyBoldFont
   Text	Fett

4. Drücken Sie die EINGABETASTE, um die Einfügemarke unter das erste Kontrollkästchen zu bewegen.

5. Fügen Sie dem Dokument unterhalb des ApplyBoldFont-Kontrollkästchens ein zweites Kontrollkästchen hinzu, und ändern Sie die folgenden Eigenschaften.

   Property	Value
   Name	applyItalicFont
   Text	Kursiv

6. Drücken Sie die EINGABETASTE, um die Einfügemarke unter das zweite Kontrollkästchen zu bewegen.

7. Fügen Sie dem Dokument unterhalb des ApplyItalicFont-Kontrollkästchens ein drittes Kontrollkästchen hinzu, und ändern Sie die folgenden Eigenschaften.

   Property	Value
   Name	applyUnderlineFont
   Text	Unterstreichen

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

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

2. Ziehen Sie von der Registerkarte Word-Steuerelemente der Toolbox ein Bookmark-Steuerelement in das Dokument.

   Das Dialogfeld Lesezeichen-Steuerelement hinzufügen wird angezeigt.

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

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

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument, und klicken Sie anschließend im Kontextmenü auf Code anzeigen.

2. Fügen Sie der ThisDocument-Klasse die folgenden Konstanten hinzu (nur C#).

   const int WordTrue = -1;
   const int WordFalse = 0;
   

3. 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;
       }
   }
   

4. 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;
       }
   }
   

5. 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;
       }
   }
   

6. 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 Visual Studio Tools for Office.

   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

1. Drücken Sie F5, um das Projekt auszuführen.

2. Aktivieren bzw. deaktivieren Sie ein Kontrollkästchen.

3. Ü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:

• Verwenden einer Schaltfläche zum Auffüllen eines Textfelds. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Anzeigen von Text in einem Textfeld in einem Dokument mithilfe einer Schaltfläche.

• Verwenden von Optionsfeldern, um Diagrammstile auszuwählen. Weitere Informationen hierzu finden Sie unter Exemplarische Vorgehensweise: Aktualisieren eines Diagramms in einem Dokument mithilfe von Optionsfeldern.

Siehe auch

Konzepte

Exemplarische Vorgehensweisen in Word

NamedRange-Steuerelement

Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten

Weitere Ressourcen

Beispiele und exemplarische Vorgehensweisen für die Programmierung mit Office