Exemplarische Vorgehensweise: Ändern der Arbeitsblattformatierung mithilfe von 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 Excel 2003 Excel 2007 Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die Grundlagen zum Ändern der Formatierung mithilfe von Kontrollkästchen in einem Microsoft Office Excel-Arbeitsblatt beschrieben. Sie werden mit Visual Studio Tools for Office Code erstellen und dem Projekt hinzufügen. Das Ergebnis als vollständiges Beispiel finden Sie unter Beispiel für Excel-Steuerelemente.

In dieser exemplarischen Vorgehensweise wird Folgendes erläutert:

• Hinzufügen von Text und Steuerelementen zu einem Arbeitsblatt.

• Formatieren des Texts beim Auswählen einer Option.

• Testen des Projekts.

Hinweis:
Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio, die in den folgenden Anweisungen aufgeführt sind, angezeigt. Die von Ihnen verwendete Visual Studio-Edition und die Einstellungen legen diese Elemente fest. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Um die exemplarische Vorgehensweise nachzuvollziehen, benötigen Sie:

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

• Microsoft Office Excel 2007 bzw. Microsoft Office Excel 2003

Erstellen des Projekts

In diesem Schritt erstellen Sie mithilfe von Visual Studio Tools for Office ein Excel-Arbeitsmappenprojekt.

So erstellen Sie ein neues Projekt

• Erstellen Sie ein Excel-Arbeitsmappenprojekt mit dem Namen My Excel Formatting. Stellen Sie sicher, dass Neues Dokument erstellen ausgewählt ist. Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Visual Studio Tools for Office-Projekte.

  Visual Studio öffnet die neue Excel-Arbeitsmappe im Designer und fügt dem Projektmappen-Explorer das My Excel Formatting-Projekt hinzu.

Hinzufügen von Text und Steuerelementen zum Arbeitsblatt

In dieser exemplarischen Vorgehensweise werden drei CheckBox-Steuerelemente und ein Text in einem NamedRange-Steuerelement benötigt.

So fügen Sie drei Kontrollkästchen hinzu

1. Überprüfen Sie, ob die Arbeitsmappe und Sheet1 im Visual Studio-Designer geöffnet sind.

2. Ziehen Sie in der Toolbox von der Registerkarte Allgemeine Steuerelemente ein CheckBox-Steuerelement auf Sheet1 in oder in die Nähe von Zelle B2.

3. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

4. Stellen Sie sicher, dass im Eigenschaftenfenster im Objektnamen-Listenfeld Checkbox1 angezeigt wird, und ändern Sie die folgenden Eigenschaften:

   Property	Value
   Name	applyBoldFont
   Text	Fett

5. Ziehen Sie ein zweites Kontrollkästchen in oder in die Nähe von Zelle B4, und ändern Sie die folgenden Eigenschaften:

   Property	Value
   Name	applyItalicFont
   Text	Kursiv

6. Ziehen Sie ein drittes Kontrollkästchen in oder in die Nähe von Zelle B6, und ändern Sie die folgenden Eigenschaften:

   Property	Value
   Name	applyUnderlineFont
   Text	Unterstreichen

7. Wählen Sie alle drei Kontrollkästchen-Steuerelemente aus, indem Sie STRG gedrückt halten.

8. Klicken Sie auf der Excel-Symbolleiste auf Links ausrichten und anschließend auf Vertikalen Abstand angleichen.

   Die drei Kontrollkästchen-Steuerelemente haben jetzt den gleichen vertikalen Abstand und sind an der Position des ersten ausgewählten Steuerelements linksseitig ausgerichtet.

   Ziehen Sie als Nächstes ein NamedRange-Steuerelement auf das Arbeitsblatt.

   Hinweis:
   Sie können auch das NamedRange-Steuerelement hinzufügen, indem Sie in das Feld NametextFont eingeben.

So fügen Sie einem NamedRange-Steuerelement Text hinzu

1. Ziehen Sie von der Registerkarte Excel-Steuerelemente der Toolbox ein NamedRange-Steuerelement auf die Zelle B9.

2. Stellen Sie sicher, dass im bearbeitbaren Textfeld $B$9 angezeigt wird und dass die Zelle B9 ausgewählt ist. Wenn dies nicht der Fall ist, klicken Sie auf die Zelle B9, um diese auszuwählen.

3. Klicken Sie auf OK.

4. Zelle B9 wird zum Bereich NamedRange1.

   Auf dem Arbeitsblatt gibt es dafür keinen sichtbaren Hinweis, aber wenn Zelle B9 ausgewählt ist, wird NamedRange1 im Feld Name (auf der linken Seite direkt über dem Arbeitsblatt) angezeigt.

5. Stellen Sie sicher, dass im Eigenschaftenfenster im Objektnamen-Listenfeld NamedRange1 angezeigt wird, und ändern Sie die folgenden Eigenschaften:

   Property	Value
   Name	textFont
   Value2	Klicken Sie auf ein Kontrollkästchen, um die Formatierung des Texts zu ändern.

Als Nächstes schreiben Sie Code, der den Text beim Auswählen einer Option formatiert.

Formatieren des Texts beim Auswählen einer Option

In diesem Abschnitt schreiben Sie Code, der beim Auswählen einer Formatierungsoption durch den Benutzer das Textformat im Arbeitsblatt ändert.

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

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

2. 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.textFont.Font.Bold = Me.applyBoldFont.Checked
   End Sub
   

   private void applyBoldFont_Click(object sender, EventArgs e)
   {
       this.textFont.Font.Bold = this.applyBoldFont.Checked;
   }
   

3. 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.textFont.Font.Italic = Me.applyItalicFont.Checked
   End Sub
   

   private void applyItalicFont_Click(object sender, EventArgs e)
   {
       this.textFont.Font.Italic = this.applyItalicFont.Checked;
   }
   

4. 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.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleSingle
       Else
           Me.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleNone
       End If
   End Sub
   

   private void applyUnderlineFont_Click(object sender, EventArgs e)
   {
       if (this.applyUnderlineFont.Checked == true)
       {
           this.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleSingle;
       }
       else
       {
           this.textFont.Font.Underline = Excel.XlUnderlineStyle.xlUnderlineStyleNone;
       }
   }
   

5. In C# müssen Sie, wie im Folgenden gezeigt, Ereignishandler für die Kontrollkästchen zum Startup-Ereignis hinzufügen. Informationen über das 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 die Arbeitsmappe nun testen, um sicherzustellen, dass der Text beim Aktivieren bzw. Deaktivieren eines Kontrollkästchens richtig formatiert wird.

So testen Sie die Arbeitsmappe

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 und das Formatieren von Texten in Excel-Arbeitsblättern erläutert. Die folgenden Aufgaben könnten sich daran anschließen:

• Bereitstellen des Projekts. Weitere Informationen finden Sie unter Bereitstellen von Office-Projektmappen.

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

Siehe auch

Konzepte

Exemplarische Vorgehensweisen in Excel

NamedRange-Steuerelement

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