Exemplarische Vorgehensweise: Ändern des Aktionsbereichs gemäß dem Benutzerkontext

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 hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise wird die Reaktion auf XMLNode-Ereignisse veranschaulicht. Wenn ein Benutzer den Cursor durch ein Dokument bewegt, werden Steuerelemente im Aktionsbereich aus- bzw. eingeblendet.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

• Hinzufügen von Steuerelementen zum Aktionsbereich

• Anzeigen des Aktionsbereichs, wenn die Anwendung geöffnet wird

• Ein- und Ausblenden von Steuerelementen im Aktionsbereich auf der Grundlage von Benutzeraktionen in XML-Knoten

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.

Hinweis:
Sie können diese exemplarische Vorgehensweise auch mit Word 2007 ausführen. Bei einigen der Anweisungen wird allerdings davon ausgegangen, dass Sie die Menüs in Word 2003 verwenden.

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 My Dynamic Actions Pane. 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 das Eigener dynamischer Aktionsbereich-Projekt zum Projektmappen-Explorer hinzu.

Erstellen eines Schemas für die Zuordnung zum Dokument

Um die XML-Knoten zu erstellen, ziehen Sie Elemente von einem XML-Schema ins Dokument. Erstellen Sie zunächst eine Schemadatei, dann ein Dokument, das dem Schema entspricht, und ordnen Sie anschließend dem Dokument die Elemente zu.

So erstellen Sie das XML-Schema

1. Wählen Sie im Projektmappen-Explorer das Projekt Eigener dynamischer Aktionsbereich aus.

2. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

   Das Dialogfeld Neues Element hinzufügen wird angezeigt.

3. Wählen Sie im Bereich Vorlagen die Option XML-Schema aus.

4. Bezeichnen Sie das Schema als ActionsPaneSample.xsd, und klicken Sie auf Hinzufügen.

5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ActionsPaneSample.xsd, und klicken Sie dann auf Öffnen mit.

6. Wählen Sie im Dialogfeld Öffnen mit die Option XML-Editor aus, und klicken Sie dann auf OK.

7. Ersetzen Sie den Text im XML-Editor durch folgenden Text.

   <?xml version="1.0" encoding="utf-8" ?>
   <xs:schema targetNamespace="https://schemas.microsoft.com/vsto/samples" elementFormDefault="qualified"
       xmlns="https://schemas.microsoft.com/vsto/samples"
       xmlns:mstns="https://schemas.microsoft.com/vsto/samples"
       xmlns:xs="http://www.w3.org/2001/XMLSchema">
     <xs:element name="Sample" type="SampleType"></xs:element>
     <xs:complexType name="SampleType">
       <xs:all>
         <xs:element name="Insert" type="InsertType" minOccurs="0" maxOccurs="1" />
         <xs:element name="Table" type="xs:string" minOccurs="0" maxOccurs="1" />
       </xs:all>
     </xs:complexType>
     <xs:complexType name="InsertType">
       <xs:sequence>
         <xs:element name="MemoTo" type="xs:string" minOccurs="1" maxOccurs="1"/>
         <xs:element name="MemoFrom" type="xs:string" minOccurs="1" maxOccurs="1"/>
         <xs:element name="MemoSubject" type="xs:string" minOccurs="1" maxOccurs="1"/>
       </xs:sequence>
     </xs:complexType>
   </xs:schema>
   

8. Speichern Sie das Projekt.

Hinzufügen von Text und XML zum Dokument

Das Dokument für diese exemplarische Vorgehensweise liegt in Form einer Mitteilung vor. Fügen Sie Text zum Dokument hinzu, und ordnen Sie danach Stellen im Dokument XML-Elemente zu.

So fügen Sie dem Dokument Text hinzu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument.cs bzw. ThisDocument.vb, und klicken Sie dann auf Ansicht-Designer.

2. Fügen Sie dem Word-Dokument den folgenden Text hinzu.

   MITTEILUNG

   To:

   From:

   Subject:

   In der folgenden Tabelle werden die angeforderten Kontaktinformationen aufgelistet:

   Name	Address	City	State	Postal Code
   Nancy Davolio	507 - 20th Ave. E., Apt. 2A	Seattle	WA	98122

Ordnen Sie anschließend dem Text in der Mitteilung XML-Elemente zu. Für jedes zugeordnete XML-Element wird ein XMLNode-Steuerelement erstellt. Das XMLNode-Steuerelement wird durch Anhängen der über- und untergeordneten Elementnamen an Node bezeichnet. Wenn Sie beispielsweise das Insert-Element aus dem obigen Schema zuordnen, wird es als SampleInsertNode bezeichnet. Weitere Informationen zu Steuerelementen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.

So fügen Sie das Schema ans Dokument an

1. Öffnen Sie das Dialogfeld Vorlagen und Add-Ins. Gehen Sie in Word 2007 dazu folgendermaßen vor:

   1. Klicken Sie in der Multifunktionsleiste auf die Registerkarte Entwickler.

      Hinweis:
      Wenn die Registerkarte Entwickler nicht sichtbar ist, müssen Sie diese zuerst anzeigen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Anzeigen der Registerkarte "Entwickler" auf der Multifunktionsleiste.

   2. Klicken Sie in der Gruppe XML auf Schema.

      Das Dialogfeld Vorlagen und Add-Ins wird geöffnet.

   So öffnen Sie das Dialogfeld Vorlagen und Add-Ins in Word 2003:

   1. Zeigen Sie im Menü Extras auf Microsoft Office Word-Tools, und klicken Sie dann auf Vorlagen und Add-Ins.

      Das Dialogfeld Vorlagen und Add-Ins wird geöffnet.

      Hinweis:
      Wenn Microsoft Office Word-Tools im Menü Extras nicht verfügbar ist, klicken Sie auf das Dokument, um ihm den Fokus zuzuweisen. Weitere Informationen hierzu finden Sie unter Office-Menüs in der Visual Studio-Umgebung.

2. Klicken Sie im Dialogfeld Vorlagen und Add-Ins auf die Registerkarte XML-Schema und dann auf Schema hinzufügen.

3. Wählen Sie das zuvor erstellte ActionsPaneSample.xsd-Schema aus, das sich im Projektverzeichnis befindet, und klicken Sie auf Öffnen.

4. Klicken Sie im Dialogfeld Schemaeinstellungen auf OK.

5. Klicken Sie auf OK, um das Dialogfeld Vorlagen und Add-Ins zu schließen.

   Der Aufgabenbereich XML-Struktur wird geöffnet.

So ordnen Sie dem Dokument XML-Elemente zu

1. Klicken Sie im XML-Struktur-Aufgabenbereich auf das Sample-Element.

2. Klicken Sie nach der Aufforderung auf Für das gesamte Dokument übernehmen.

3. Wählen Sie die drei Textzeilen mit To, From und Subject aus. Klicken Sie dann im Aufgabenbereich XML-Struktur auf das Element Einfügen.

4. Setzen Sie den Cursor auf To:, drücken Sie die TAB-TASTE zweimal, und klicken Sie auf das Element MemoTo.

5. Setzen Sie den Cursor auf From:, drücken Sie die TAB-TASTE zweimal, und klicken Sie auf das Element MemoFrom.

6. Setzen Sie den Cursor auf Subject:, drücken Sie die TAB-TASTE einmal, und klicken Sie auf das Element MemoSubject.

7. Wählen Sie die Tabelle aus, um sie hervorzuheben, und klicken Sie auf das Element Tabelle, um sie zuzuweisen.

   Die XML-Tags werden innerhalb der Tabellenzellen angezeigt.

8. Deaktivieren Sie das Kontrollkästchen XML-Tag im Dokument anzeigen.

9. Klicken Sie am unteren Rand des XML-Struktur-Aufgabenbereichs auf XML-Optionen.

10. Aktivieren Sie das Kontrollkästchen Gemischte Inhalte ignorieren, und klicken Sie auf OK.

11. Schließen Sie den XML-Struktur-Aufgabenbereich.

Hinzufügen von Steuerelementen zum Aktionsbereich

Um das Layout der Steuerelemente im Aktionsbereich anzulegen, verwenden Sie den Designer eines Steuerelements, das als Aktionsbereich-Steuerelement bezeichnet wird und im Prinzip einem Benutzersteuerelement entspricht. Sie können andere Steuerelemente, z. B. Schaltflächen und Textfelder, auf das Aktionsbereich-Steuerelement ziehen und sie anordnen. Um den Aktionsbereich entsprechend dem Benutzerkontext zu ändern, entwerfen Sie für jeden Kontext ein Aktionsbereich-Steuerelement und fügen es hinzu. Anschließend blenden Sie die Aktionsbereich-Steuerelemente wie gewünscht ein bzw. aus.

In dieser exemplarischen Vorgehensweise werden drei Aktionsbereich-Steuerelemente verwendet. Das erste Aktionsbereich-Steuerelement enthält drei Textfelder und eine Schaltfläche, sodass Benutzer Daten eingeben und dem Dokument hinzufügen können. Das zweite Aktionsbereich-Steuerelement enthält eine Schaltfläche, mit der das Dialogfeld Tabelleneigenschaften geöffnet wird. Das dritte Aktionsbereich-Steuerelement enthält ein Kontrollkästchen, mit dem sich alle Steuerelemente im Aktionsbereich anzeigen lassen, unabhängig davon, an welcher Stelle im Dokument sich der Cursor befindet.

So fügen Sie ein Aktionsbereich-Steuerelement hinzu

1. Wählen Sie im Projektmappen-Explorer das Projekt Eigener dynamischer Aktionsbereich aus.

2. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

3. Klicken Sie im Dialogfeld Neues Element hinzufügen auf Aktionsbereich-Steuerelement, nennen Sie es AddTextControl, und klicken Sie auf Hinzufügen.

4. Ändern Sie die Size-Eigenschaft des Aktionsbereich-Steuerelements auf 170, 135.

So fügen Sie dem ersten Aktionsbereich-Steuerelement Windows Forms-Steuerelemente hinzu

1. Ziehen Sie in Toolbox aus der Registerkarte Windows Forms ein Label-Steuerelement auf AddTextControl, und ändern Sie die Eigenschaft Text auf To:.

2. Fügen Sie AddTextControl ein Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	toBox
   Size	110, 20

3. Fügen Sie AddTextControl ein zweites Label-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft auf From:.

4. Fügen Sie AddTextControl ein zweites Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	fromBox
   Size	110, 20

5. Fügen Sie AddTextControl unterhalb des vorherigen Textfelds ein drittes Label-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft auf Subject:.

6. Fügen Sie AddTextControl neben der vorherigen Bezeichnung ein drittes Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	subjectBox
   Multiline	True
   Size	110, 40

7. Ändern Sie die Größe des subjectBox-Textfelds, um mehrere Zeilen zuzulassen.

8. Fügen Sie AddTextControl ein Button-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	insertText
   Text	Insert

So erstellen Sie das zweite Aktionsbereich-Steuerelement

1. Fügen Sie dem Projekt ein zweites Aktionsbereich-Steuerelement hinzu, und nennen Sie es ShowPropertiesControl.

2. Ändern Sie die Size-Eigenschaft des Aktionsbereich-Steuerelements auf 170, 50.

3. Ziehen Sie von der Registerkarte Windows Forms der Toolbox ein Button-Steuerelement auf ShowPropertiesControl, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	tableProperties
   Text	Tabelleneigenschaften
   ENABLED	False
   Size	100, 23

4. Ändern Sie für C# die Modifiers-Eigenschaft der Schaltfläche in Internal.

So erstellen Sie das dritte Aktionsbereich-Steuerelement

1. Fügen Sie dem Projekt ein drittes Aktionsbereich-Steuerelement hinzu, und nennen Sie es ShowAllControl.

2. Ändern Sie die Size-Eigenschaft des Aktionsbereich-Steuerelements auf 170, 75.

3. Fügen Sie von der Registerkarte Windows Forms der Toolbox zu ShowAllControl ein GroupBox-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft in My Actions Pane.

4. Fügen Sie zu ShowAllControl oberhalb des Gruppenfelds ein CheckBox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	showCheck
   Text	Anzeigen aller Steuerelemente

5. Ändern Sie für C# die Modifiers-Eigenschaft des Kontrollkästchens in Internal.

Hinzufügen von Code, um auf den Benutzerkontext reagieren zu können

Nun können Sie Code zum Anzeigen des Aktionsbereichs schreiben und entsprechend der Cursorposition im Dokument Aktionsbereich-Steuerelemente hinzufügen und entfernen. Der Code wird in den Ereignishandlern der XMLNode-Steuerelemente gespeichert.

So fügen Sie XMLNode-Steuerelementereignissen Code hinzu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument.vb bzw. ThisDocument.cs, und klicken Sie dann auf Code anzeigen.

2. Erstellen Sie eine Variablenreferenz für jedes Aktionsbereich-Steuerelement im Deklarationsabschnitt von ThisDocument.

   Dim addText As New AddTextControl
   Dim showProperties As New ShowPropertiesControl
   Dim showAll As New ShowAllControl
   
   Friend WithEvents showCheck As System.Windows.Forms.CheckBox
   

   private AddTextControl addText = new AddTextControl();
   private ShowPropertiesControl showProperties = new ShowPropertiesControl();
   private ShowAllControl showAll = new ShowAllControl();
   

3. Schreiben Sie im Startup-Ereignishandler von ThisDocument den folgenden Code, um das ShowAllControl-Steuerelement hinzuzufügen und den Aktionsbereich anzuzeigen.

   Me.ActionsPane.Controls.Add(showAll)
   showCheck = showAll.showCheck
   

   this.ActionsPane.Controls.Add(showAll);
   

   Hinweis:

   Die Reihenfolge, in der Sie Steuerelemente dem Aktionsbereich hinzufügen, bestimmt deren Platzierung. Ein Steuerelement, das im oberen Teil des Aktionsbereichs immer sichtbar sein soll, sollten Sie zuerst hinzufügen Die Reihenfolge ist auch von der StackOrder-Eigenschaft des Aktionsbereichs abhängig. Weitere Informationen finden Sie unter Gewusst wie: Verwalten des Steuerelementlayouts in Aktionsbereichen.

4. Fügen Sie dem ContextEnter-Ereignishandler des SampleInsertNode-Steuerelements den folgenden Code hinzu.

   Private Sub SampleInsertNode_ContextEnter(ByVal sender As Object, _
       ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
       Handles SampleInsertNode.ContextEnter
   
       If showAll.showCheck.Checked = False Then
           Me.ActionsPane.Controls.Add(addText)
           Me.ActionsPane.Controls.Remove(showProperties)
       End If
   End Sub
   

   private void SampleInsertNode_ContextEnter(object sender, 
       Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
   {
       if (showAll.showCheck.Checked == false)
       {
           this.ActionsPane.Controls.Add(addText);
           this.ActionsPane.Controls.Remove(showProperties);
       }
   }
   

5. Fügen Sie dem ContextLeave-Ereignishandler des SampleInsertNode-Steuerelements den folgenden Code hinzu, um das Steuerelement auszublenden, nachdem der Benutzer den Cursor außerhalb dieses XML-Knotens bewegt hat.

   Private Sub SampleInsertNode_ContextLeave(ByVal sender As Object, _
       ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
       Handles SampleInsertNode.ContextLeave
   
       If showAll.showCheck.Checked = False Then
           Me.ActionsPane.Controls.Remove(addText)
       End If
   End Sub
   

   private void SampleInsertNode_ContextLeave(object sender,
       Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
   {
       if (showAll.showCheck.Checked == false)
       {
           this.ActionsPane.Controls.Remove(addText);
       }
   }
   

6. Fügen Sie dem ContextEnter-Ereignishandler des SampleTableNode-Steuerelements den folgenden Code hinzu.

   Private Sub SampleTableNode_ContextEnter(ByVal sender As Object, _
       ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
       Handles SampleTableNode.ContextEnter
   
       If showAll.showCheck.Checked = False Then
           Me.ActionsPane.Controls.Remove(addText)
           Me.ActionsPane.Controls.Add(showProperties)
       End If
   
       showProperties.tableProperties.Enabled = True
   End Sub
   

   private void SampleTableNode_ContextEnter(object sender,
       Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
   {
       if (showAll.showCheck.Checked == false)
       {
           this.ActionsPane.Controls.Remove(addText);
           this.ActionsPane.Controls.Add(showProperties);
       }
       showProperties.tableProperties.Enabled = true;
   }
   

7. Fügen Sie dem ContextLeave-Ereignishandler des SampleTableNode-Steuerelements den folgenden Code hinzu, um das Steuerelement auszublenden, nachdem der Benutzer den Cursor außerhalb dieses XML-Knotens bewegt hat.

   Private Sub SampleTableNode_ContextLeave(ByVal sender As Object, _
       ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
       Handles SampleTableNode.ContextLeave
   
       If showAll.showCheck.Checked = False Then
           Me.ActionsPane.Controls.Remove(showProperties)
       End If
   
       showProperties.tableProperties.Enabled = False
   End Sub
   

   private void SampleTableNode_ContextLeave(object sender,
       Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
   {
       if (showAll.showCheck.Checked == false)
       {
           this.ActionsPane.Controls.Remove(showProperties);
       }
       showProperties.tableProperties.Enabled = false;
   }
   

8. In C# müssen Sie Ereignishandler für die XMLNode-Steuerelemente hinzufügen. Sie können diesen Code in den Startup-Ereignishandler von ThisDocument einfügen. Weitere Informationen zum Erstellen von Ereignishandlern finden Sie unter Gewusst wie: Erstellen von Ereignishandlern in Visual Studio Tools for Office.

   this.SampleInsertNode.ContextEnter += new Microsoft.Office.Tools.Word.
       ContextChangeEventHandler(SampleInsertNode_ContextEnter);
   
   this.SampleInsertNode.ContextLeave += new Microsoft.Office.Tools.Word.
       ContextChangeEventHandler(SampleInsertNode_ContextLeave);
   
   this.SampleTableNode.ContextEnter += new Microsoft.Office.Tools.Word.
       ContextChangeEventHandler(SampleTableNode_ContextEnter);
   
   this.SampleTableNode.ContextLeave += new Microsoft.Office.Tools.Word.
       ContextChangeEventHandler(SampleTableNode_ContextLeave);
   

Anhaltepunkt

Speichern Sie das Projekt, und überprüfen Sie, ob sich die Aktionsbereich-Steuerelemente ändern, wenn Sie den Cursor durch das Dokument bewegen.

So testen Sie das Projekt

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

2. Bewegen Sie die Einfügemarke auf das Wort To, und stellen Sie sicher, dass das addText-Aktionsbereich-Steuerelement im Aktionsbereich sichtbar ist.

3. Bewegen Sie die Einfügemarke innerhalb der Tabelle, und stellen Sie sicher, dass das showProperties-Aktionsbereich-Steuerelement im Aktionsbereich sichtbar ist.

4. Bewegen Sie die Einfügemarke auf das Wort MITTEILUNG, und stellen Sie sicher, dass weder das addText-Aktionsbereich-Steuerelement noch das showProperties-Aktionsbereich-Steuerelement im Aktionsbereich sichtbar sind.

Hinzufügen von Code, um auf Steuerelementereignisse im Aktionsbereich reagieren zu können

Bisher bewirken die Steuerelemente im Aktionsbereich nichts. Der letzte Schritt besteht im Schreiben von Code zum Anzeigen aller Steuerelemente, zum Einfügen von Text sowie zum Anzeigen des Dialogfelds Tabelleneigenschaften.

So zeigen Sie alle Steuerelemente im Aktionsbereich an

1. Fügen Sie ThisDocument den folgenden Code hinzu.

   Private Sub showCheck_CheckStateChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles showCheck.CheckStateChanged
   
       If showAll.showCheck.Checked = True Then
           Me.ActionsPane.Controls.Add(addText)
           Me.ActionsPane.Controls.Add(showProperties)
       Else
           Me.ActionsPane.Controls.Remove(addText)
           Me.ActionsPane.Controls.Remove(showProperties)
       End If
   End Sub
   

   private void showCheck_CheckStateChanged(object sender, EventArgs e)
   {
       if (showAll.showCheck.Checked)
       {
           this.ActionsPane.Controls.Add(addText);
           this.ActionsPane.Controls.Add(showProperties);
       }
       else
       {
           this.ActionsPane.Controls.Remove(addText);
           this.ActionsPane.Controls.Remove(showProperties);
       }
   }
   

2. In C# müssen Sie einen Ereignishandler für das checkbox-Steuerelement erstellen. Sie können diesen Code in den Startup-Ereignishandler von ThisDocument einfügen.

   showAll.showCheck.CheckStateChanged += new EventHandler(showCheck_CheckStateChanged);
   

So fügen Sie Text ein, wenn auf die Schaltfläche Einfügen geklickt wird

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf AddTextControl.vb bzw. AddTextControl.cs, und klicken Sie dann auf Code anzeigen.

2. Schreiben Sie im Click-Ereignishandler der Schaltfläche insertText folgenden Code.

   Private Sub insertText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles insertText.Click
   
       With Globals.ThisDocument
           .InsertMemoFromNode.Text = Me.fromBox.Text
           .InsertMemoToNode.Text = Me.toBox.Text
           .InsertMemoSubjectNode.Text = Me.subjectBox.Text
       End With
   
       ' Clear the text boxes.
       Me.fromBox.Text = ""
       Me.toBox.Text = ""
       Me.subjectBox.Text = ""
   End Sub
   

   private void insertText_Click(object sender, System.EventArgs e)
   {
       Globals.ThisDocument.InsertMemoFromNode.Text = this.fromBox.Text;
       Globals.ThisDocument.InsertMemoToNode.Text = this.toBox.Text;
       Globals.ThisDocument.InsertMemoSubjectNode.Text = this.subjectBox.Text;
   
       // Clear the text boxes.
       this.fromBox.Text = "";
       this.toBox.Text = "";
       this.subjectBox.Text = "";
   }
   

3. In C# müssen Sie einen Ereignishandler für die Schaltfläche hinzufügen. Sie können diesen Code im AddTextControl-Konstruktor nach dem Aufruf von InitializeComponent platzieren.

   public AddTextControl()
   {
       InitializeComponent();
       this.insertText.Click += new System.EventHandler(this.insertText_Click);
   }
   

So zeigen Sie das Dialogfeld Tabelleneigenschaften an

1. Klicken Sie mit der rechten Maustaste im Projektmappen-Explorer auf ShowPropertiesControl.vb bzw. ShowPropertiesControl.cs, und klicken Sie dann auf Code anzeigen.

2. Fügen Sie dem Click-Ereignishandler der Schaltfläche tableProperties folgenden Code hinzu.

   Private Sub tableProperties_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles tableProperties.Click
   
       Globals.ThisDocument.Application.Dialogs( _
           Word.WdWordDialog.wdDialogTableProperties).Show()
   End Sub
   

   private void tableProperties_Click(object sender, System.EventArgs e)
   {
       object timeout = 0;
   
       Globals.ThisDocument.Application.Dialogs[
           Microsoft.Office.Interop.Word.WdWordDialog.wdDialogTableProperties]
               .Show(ref timeout);
   }
   

3. In C# müssen Sie einen Ereignishandler für die Schaltfläche hinzufügen. Sie können diesen Code im ShowPropertiesControl-Konstruktor nach dem Aufruf von InitializeComponent platzieren.

   public ShowPropertiesControl()
   {
       InitializeComponent();
       this.tableProperties.Click += new System.EventHandler(this.tableProperties_Click);
   }
   

Testen der Anwendung

Sie können das Dokument nun weiter testen, um die Funktionalität der Aktionsbereich-Steuerelemente zu überprüfen.

So testen Sie das Dokument

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

2. Bestätigen Sie, dass der Aktionsbereich angezeigt wird.

3. Bewegen Sie den Cursor zum Abschnitt des Dokuments, der die Zeilen To, From und Subject enthält, und bestätigen Sie, dass das addText-Steuerelement im Aktionsbereich angezeigt wird.

4. Geben Sie in die Textfelder To, From und Subject im Aktionsbereich Text ein, und klicken Sie auf Einfügen.

5. Bewegen Sie den Cursor zur Tabelle, und bestätigen Sie, dass das showProperties-Steuerelement im Aktionsbereich angezeigt wird.

6. Klicken Sie auf die Schaltfläche Tabelleneigenschaften, und bestätigen Sie, dass das Dialogfeld Tabelleneigenschaften geöffnet wird.

7. Klicken Sie auf das Kontrollkästchen Alle anzeigen, und bestätigen Sie, dass alle Steuerelemente im Aktionsbereich sichtbar sind.

8. Bewegen Sie den Cursor außerhalb der Tabelle, und bestätigen Sie, dass die Schaltfläche Tabelleneigenschaften deaktiviert wird.

Nächste Schritte

Diese exemplarische Vorgehensweise erläutert die Grundlagen zum Ändern des Aktionsbereichs, basierend auf dem Benutzerkontext. Die folgenden Aufgaben könnten sich daran anschließen:

• Bereitstellen des Projekts. Weitere Informationen hierzu finden Sie unter Gewusst wie: Bereitstellen von Office-Projektmappen (2003 System).

• Datenbindung an Steuerelemente in Word. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Binden von Daten an Steuerelemente in einem Word-Aktionsbereich.

• Datenbindung an Steuerelemente in Excel. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Bindung von Daten an Steuerelemente in einem Excel-Aktionsbereich.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen eines Aktionsbereichs zu Word-Dokumenten

Gewusst wie: Hinzufügen eines Aktionsbereichs zu Excel-Arbeitsmappen

Gewusst wie: Verwalten des Steuerelementlayouts in Aktionsbereichen

Konzepte

Aktionsbereichsübersicht

XMLNodes-Steuerelement