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

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

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, 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

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 My Basic 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 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

  Address

  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

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

   Das Dialogfeld Lesezeichen-Steuerelement hinzufügen wird angezeigt.

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

3. Ändern Sie im Eigenschaftenfenster die Name-Eigenschaft von Bookmark1 in showName.

4. Markieren Sie das Wort Address ohne die Absatzmarke.

5. Führen Sie einen der folgenden Schritte aus:

   • Für Word 2003: Klicken Sie im Menü Einfügen auf Lesezeichen.

   • Für Word 2007: Klicken Sie auf der Registerkarte Einfügen der Multifunktionsleiste in der Gruppe Links auf Lesezeichen.

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

1. Wählen Sie im Projektmappen-Explorer das Projekt Eigener Bereich Grundlegende Aktionen aus.

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

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

1. Wenn das Aktionsbereich-Steuerelement im Designer nicht sichtbar ist, doppelklicken Sie auf InsertTextControl im Designer.

2. Ziehen Sie von der Registerkarte Allgemeine Steuerelemente der Toolbox ein Label-Steuerelement zum Aktionsbereich-Steuerelement.

3. Ändern Sie die Text-Eigenschaft des Label-Steuerelements auf Name.

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

   Eigenschaft	Wert
   Name	getName
   Size	130, 20

5. Fügen Sie dem Aktionsbereich-Steuerelement ein zweites Label-Steuerelement hinzu, und ändern Sie die Text-Eigenschaft auf Address.

6. 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
   Size	130, 40

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

   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 hierzu finden Sie unter Globaler Zugriff auf eigene Objekte in Visual Studio Tools for Office-Projekte.

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

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

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

   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

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

   Dim insertText As New InsertTextControl
   

   private InsertTextControl insertText = new InsertTextControl();
   

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

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

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

3. 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 hierzu finden Sie unter Gewusst wie: Hinzufügen eines Aktionsbereichs zu Excel-Arbeitsmappen.

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

• Anzeigen und Ausblenden von Steuerelementen im Aktionsbereich. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Ändern des Aktionsbereichs gemäß dem Benutzerkontext.

Siehe auch

Aufgaben

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

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

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

Gewusst wie: Verwalten des Steuerelementlayouts in Aktionsbereichen

Konzepte

Aktionsbereichsübersicht

Bookmark-Steuerelement