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

Artikel
08/10/2011

Wichtig Die in diesem Thema genannten Informationen zu Microsoft Word sind ausschließlich für Personen und Organisationen vorgesehen, die sich außerhalb der Vereinigten Staaten und ihrer Außengebiete befinden oder die Programme verwenden oder entwickeln, die unter Microsoft Word-Produkten ausgeführt werden, die von Microsoft vor Januar 2010 lizenziert wurden, als Microsoft eine Implementierung bestimmter Funktionen entfernte, die mit benutzerdefiniertem XML aus Microsoft Word zusammenhingen. Diese Informationen bezüglich Microsoft Word dürfen nicht von Personen oder Organisationen in den Vereinigten Staaten oder ihren Außengebieten verwendet werden, die Programme verwenden oder entwickeln, die unter Microsoft Word-Produkten ausgeführt werden, die von Microsoft nach dem 10. Januar 2010 lizenziert wurden. Diese Produkte verhalten sich nicht wie Produkte, die vor diesem Datum lizenziert oder für die Verwendung außerhalb der Vereinigten Staaten erworben und lizenziert wurden.

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.

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:

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

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 My Dynamic Actions Pane. 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 das Mein 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

Wählen Sie im Projektmappen-Explorer das Projekt Mein dynamischer Aktionsbereich aus.
Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

Das Dialogfeld Neues Element hinzufügen wird angezeigt.
Wählen Sie im Bereich Vorlagen die Option XML-Schema aus.
Benennen Sie das Schema "ActionsPaneSample.xsd", und klicken Sie auf Hinzufügen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ActionsPaneSample.xsd, und klicken Sie dann auf Öffnen mit.
Wählen Sie im Dialogfeld Öffnen mit die Option XML-Editor aus, und klicken Sie dann auf OK.

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>

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

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument.cs bzw. ThisDocument.vb, und klicken Sie dann auf Ansicht-Designer.
Fügen Sie dem Word-Dokument den folgenden Text hinzu.

MITTEILUNG

To:

From:

Subject:

In der folgenden Tabelle werden die angeforderten Kontaktinformationen aufgelistet:

Name

Adresse

City

Zustand

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 über Steuerelemente finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.

So fügen Sie das Schema ans Dokument an

Klicken Sie im Menüband auf die Registerkarte Entwickler.

Tipp

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

Das Dialogfeld Vorlagen und Add-Ins wird geöffnet.
Klicken Sie im Dialogfeld Vorlagen und Add-Ins auf die Registerkarte XML-Schema und dann auf Schema hinzufügen.
Wählen Sie das zuvor erstellte ActionsPaneSample.xsd-Schema aus, das sich im Projektverzeichnis befindet, und klicken Sie auf Öffnen.
Klicken Sie im Dialogfeld Schemaeinstellungen auf OK.
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

Klicken Sie im XML-Struktur-Aufgabenbereich auf das Sample-Element.
Klicken Sie nach der Aufforderung auf Für das gesamte Dokument übernehmen.
Wählen Sie die drei Textzeilen mit To, From und Subject aus. Klicken Sie dann im Aufgabenbereich XML-Struktur auf das Element Einfügen.
Setzen Sie den Cursor auf To:, drücken Sie die TAB-TASTE zweimal, und klicken Sie auf das Element MemoTo.
Setzen Sie den Cursor auf From:, drücken Sie die TAB-TASTE zweimal, und klicken Sie auf das Element MemoFrom.
Setzen Sie den Cursor auf Subject:, drücken Sie die TAB-TASTE einmal, und klicken Sie auf das Element MemoSubject.
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.
Deaktivieren Sie das Kontrollkästchen XML-Tag im Dokument anzeigen.
Klicken Sie am unteren Rand des XML-Struktur-Aufgabenbereichs auf XML-Optionen.
Aktivieren Sie das Kontrollkästchen Gemischte Inhalte ignorieren, und klicken Sie auf OK.
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

Wählen Sie im Projektmappen-Explorer das Projekt Mein dynamischer Aktionsbereich aus.
Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Klicken Sie im Dialogfeld Neues Element hinzufügen auf Aktionsbereich-Steuerelement, nennen Sie es AddTextControl, und klicken Sie auf Hinzufügen.
Ändern Sie die Size-Eigenschaft des Aktionsbereich-Steuerelements auf 170, 135.

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

Ziehen Sie in Toolbox aus der Registerkarte Windows Forms ein Label-Steuerelement auf AddTextControl, und ändern Sie die Eigenschaft Text auf To:.
Fügen Sie AddTextControl ein Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

toBox

Größe

110, 20
Fügen Sie AddTextControl ein zweites Label-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft auf From:.
Fügen Sie AddTextControl ein zweites Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

fromBox

Größe

110, 20
Fügen Sie AddTextControl unterhalb des vorherigen Textfelds ein drittes Label-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft auf Subject:.
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

Größe

110, 40
Ändern Sie die Größe des subjectBox-Textfelds, um mehrere Zeilen zuzulassen.
Fügen Sie AddTextControl ein Button-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

insertText

Text

Insert

Eigenschaft	Wert
Name	toBox
Größe	110, 20

Eigenschaft	Wert
Name	fromBox
Größe	110, 20

Eigenschaft	Wert
Name	subjectBox
Multiline	True
Größe	110, 40

Eigenschaft	Wert
Name	insertText
Text	Insert

So erstellen Sie das zweite Aktionsbereich-Steuerelement

Fügen Sie dem Projekt ein zweites Aktionsbereich-Steuerelement hinzu, und nennen Sie es ShowPropertiesControl.
Ändern Sie die Size-Eigenschaft des Aktionsbereich-Steuerelements auf 170, 50.
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

Aktiviert

False

Größe

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

Eigenschaft	Wert
Name	tableProperties
Text	Tabelleneigenschaften
Aktiviert	False
Größe	100, 23

So erstellen Sie das dritte Aktionsbereich-Steuerelement

Fügen Sie dem Projekt ein drittes Aktionsbereich-Steuerelement hinzu, und nennen Sie es ShowAllControl.
Ändern Sie die Size-Eigenschaft des Aktionsbereich-Steuerelements auf 170, 75.
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".
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
Ändern Sie für C# die Modifiers-Eigenschaft des Kontrollkästchens in Internal.

Eigenschaft	Wert
Name	showCheck
Text	Anzeigen aller Steuerelemente

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

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

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();

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);
```
Tipp

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.

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);
    }
}

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);
    }
}

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

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

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

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);

Checkpoint

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

Drücken Sie F5, um das Projekt auszuführen.
Bewegen Sie die Einfügemarke auf das Wort To, und stellen Sie sicher, dass das addText-Aktionsbereich-Steuerelement im Aktionsbereich sichtbar ist.
Bewegen Sie die Einfügemarke innerhalb der Tabelle, und stellen Sie sicher, dass das showProperties-Aktionsbereich-Steuerelement im Aktionsbereich sichtbar ist.
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

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);
    }
}

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

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

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 = "";
}

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

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

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);
}

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

Drücken Sie F5, um das Projekt auszuführen.
Bestätigen Sie, dass der Aktionsbereich angezeigt wird.
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.
Geben Sie in die Textfelder To, From und Subject im Aktionsbereich Text ein, und klicken Sie auf Einfügen.
Bewegen Sie den Cursor zur Tabelle, und bestätigen Sie, dass das showProperties-Steuerelement im Aktionsbereich angezeigt wird.
Klicken Sie auf die Schaltfläche Tabelleneigenschaften, und bestätigen Sie, dass das Dialogfeld Tabelleneigenschaften geöffnet wird.
Klicken Sie auf das Kontrollkästchen Alle anzeigen, und bestätigen Sie, dass alle Steuerelemente im Aktionsbereich sichtbar sind.
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:

Datenbindung an Steuerelemente in Word. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Binden von Daten an Steuerelemente in einem Word-Aktionsbereich.
Binden von Daten an Steuerelemente in Excel. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Bindung von Daten an Steuerelemente in einem Excel-Aktionsbereich.
Bereitstellen des Projekts. Weitere Informationen finden Sie unter Übersicht über die Bereitstellung (Office-Entwicklung in Visual Studio).

Siehe auch

Freigeben über