Exemplarische Vorgehensweise: Einfügen von Text in ein Dokument aus einem Aktionsbereich

Artikel
02/26/2013

In dieser exemplarischen Vorgehensweise wird die Erstellung eines Aktionsbereichs in einem Microsoft Office Word 2003-Dokument veranschaulicht.Der Aktionsbereich enthält zwei Steuerelemente, die Benutzereingaben erfassen und den Text dann an das Dokument senden.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word 2013 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:

Entwerfen einer Schnittstelle mithilfe von Windows Forms-Steuerelementen auf einem Aktionsbereich-Steuerelement
Anzeigen des Aktionsbereichs, wenn die Anwendung geöffnet wird

Hinweis
Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten.Die von Ihnen verwendete Visual Studio-Edition und die Einstellungen legen diese Elemente fest.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 2012, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.110\).md).

Word 2013 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 Basic 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 wird das neue Word-Dokument im Designer öffnet, und im Projektmappen-Explorer wird das Projekt My Basic Actions Pane hinzugefügt.

Hinzufügen von Text und Lesezeichen im Dokument

Der Aktionsbereich sendet Text an Lesezeichen im Dokument.Wenn Sie ein Dokument entwerfen möchten, geben Sie einen kurzen Text ein, um ein einfaches Formular zu erstellen.

So fügen Sie dem Dokument Text hinzu

Geben Sie im Word-Dokument folgenden Text ein:

March 21, 2008

Name

Adresse

Dies ist ein Beispiel für einen einfachen Aktionsbereich in Word.

Sie können dem Dokument ein Bookmark-Steuerelement hinzufügen, indem Sie es in Visual Studio aus der Toolbox ziehen oder indem Sie in Word das Dialogfeld Lesezeichen verwenden.

So fügen Sie dem Dokument ein Lesezeichen-Steuerelement hinzu

Ziehen Sie von der Registerkarte Word-Steuerelemente der Toolbox ein Bookmark-Steuerelement zum Dokument.

Das Dialogfeld Lesezeichen-Steuerelement hinzufügen wird angezeigt.

Markieren Sie das Wort Name ohne die Absatzmarke, und klicken Sie auf OK.

Hinweis
Die Absatzmarke sollte nicht im Lesezeichen enthalten sein.Wenn die Absatzmarken nicht im Dokument angezeigt werden, klicken Sie auf das Menü Extras, zeigen auf Microsoft Office Word-Tools und klicken dann auf Optionen.Klicken Sie auf die Registerkarte Ansicht, und markieren Sie im Dialogfeld Optionen im Bereich Formatierungszeichen das Kontrollkästchen Absatzmarken.

Ändern Sie im Eigenschaftenfenster die Name-Eigenschaft von Bookmark1 in showName.
Markieren Sie das Wort Address ohne die Absatzmarke.
Klicken Sie auf der Registerkarte Einfügen des Menübands in der Gruppe Links auf Lesezeichen.
Im Dialogfeld Lesezeichen geben Sie im Feld LesezeichennameshowAddress ein und klicken auf Hinzufügen.

Hinzufügen von Steuerelementen zum Aktionsbereich

Um die Benutzeroberfläche von Aktionsbereichen zu entwerfen, fügen Sie ein Aktionsbereich-Steuerelement zum Projekt und anschließend Windows Forms-Steuerelemente zum Aktionsbereich-Steuerelement hinzu.

So fügen Sie ein Aktionsbereich-Steuerelement hinzu

Wählen Sie im Projektmappen-Explorer das Projekt Mein Bereich Grundlegende Aktionen aus.
Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Im Dialogfeld Neues Element hinzufügen klicken Sie auf Aktionsbereich-Steuerelement, bezeichnen das Steuerelement InsertTextControl und klicken auf Hinzufügen.

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

Wenn das Aktionsbereich-Steuerelement im Designer nicht sichtbar ist, doppelklicken Sie auf InsertTextControl im Designer.
Ziehen Sie von der Registerkarte Allgemeine Steuerelemente der Toolbox ein Label-Steuerelement zum Aktionsbereich-Steuerelement.
Ändern Sie die Text-Eigenschaft des Label-Steuerelements auf Name.
Fügen Sie dem Aktionsbereich-Steuerelement ein Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

getName

Größe

130, 20
Fügen Sie dem Aktionsbereich-Steuerelement ein zweites Label-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft auf Address.
Fügen Sie dem Aktionsbereich-Steuerelement ein zweites Textbox-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

getAddress

AcceptsReturn

True

Multiline

True

Größe

130, 40
Fügen Sie dem Aktionsbereich-Steuerelement ein Button-Steuerelement hinzu, und ändern Sie die folgenden Eigenschaften.

Eigenschaft

Wert

Name

addText

Text

Insert

Eigenschaft	Wert
Name	getName
Größe	130, 20

Eigenschaft	Wert
Name	getAddress
AcceptsReturn	True
Multiline	True
Größe	130, 40

Eigenschaft	Wert
Name	addText
Text	Insert

Hinzufügen von Code, um Text in das Dokument einzufügen

Schreiben Sie im Aktionsbereich Code, der Text aus den Textfeldern in die entsprechenden Bookmark-Steuerelemente des Dokuments einfügt.Sie können die Globals-Klasse verwenden, um über die Steuerelemente des Aktionsbereichs auf die Steuerelemente im Dokument zuzugreifen.Weitere Informationen finden Sie unter Globaler Zugriff auf Objekte in Office-Projekten.

So fügen Sie Text aus dem Aktionsbereich in ein Lesezeichen im Dokument ein

Fügen Sie den folgenden Code zum Click-Ereignishandler für die addText-Schaltfläche hinzu.

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

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

In C# müssen Sie einen Ereignishandler für Klickereignisse auf Schaltflächen hinzufügen.Sie können diesen Code nach dem Aufruf von IntializeComponent in den InsertTextControl-Konstruktor einfügen.Weitere Informationen zum Erstellen von Ereignishandlern finden Sie unter Gewusst wie: Erstellen von Ereignishandlern in Office-Projekten.
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

Hinzufügen von Code, um den Aktionsbereich anzuzeigen

Um den Aktionsbereich anzuzeigen, müssen Sie das von Ihnen erstellte Steuerelement zur Steuerelementauflistung hinzufügen.

So zeigen Sie den Aktionsbereich an

Erstellen Sie in der ThisDocument-Klasse eine neue Instanz des Aktionsbereich-Steuerelements.

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

Fügen Sie dem Startup-Ereignishandler von ThisDocument den folgenden Code hinzu.

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

Testen der Anwendung

Testen Sie das Dokument, um zu überprüfen, ob der Aktionsbereich nach dem Öffnen des Dokuments geöffnet wird und ob in den Textfeldern eingegebener Text nach dem Klicken auf die entsprechende Schaltfläche in die Lesezeichen eingefügt wird.

So testen Sie das Dokument

Drücken Sie F5, um das Projekt auszuführen.
Bestätigen Sie, dass der Aktionsbereich angezeigt wird.
Geben Sie Ihren Namen und Ihre Adresse in die Textfelder im Aktionsbereich ein, und klicken Sie auf Einfügen.

Nächste Schritte

Die folgenden Aufgaben könnten sich daran anschließen:

Erstellen eines Aktionsbereichs in Excel.Weitere Informationen finden Sie unter How to: Add an Actions Pane to Excel Workbooks.
Binden von Daten an Steuerelemente im Aktionsbereich.Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Binden von Daten an Steuerelemente in einem Word-Aktionsbereich.

Siehe auch

Freigeben über