Freigeben über


Exemplarische Vorgehensweise: Automatisieren einer Anwendung aus einem benutzerdefinierten Aufgabenbereich

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie ein benutzerdefinierter Aufgabenbereich erstellt wird, der PowerPoint automatisiert. Der benutzerdefinierte Aufgabenbereich fügt Daten in eine Folie ein, wenn der Benutzer auf ein MonthCalendar -Steuerelement im benutzerdefinierten Aufgabenbereich klickt.

Gilt für: Die Informationen in diesem Thema gelten für VSTO-Add-In-Projekte für Outlook. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Obwohl in dieser exemplarischen Vorgehensweise speziell PowerPoint verwendet wird, gelten die Konzepte in dieser exemplarischen Vorgehensweise für alle oben aufgelisteten Anwendungen.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Entwerfen der Benutzeroberfläche des benutzerdefinierten Aufgabenbereichs

  • Automatisieren von PowerPoint über den benutzerdefinierten Aufgabenbereich

  • Anzeigen des benutzerdefinierten Aufgabenbereichs in PowerPoint

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. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren von Visual Studio-IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Add-In-Projekts

Der erste Schritt besteht darin, ein VSTO-Add-In-Projekt für PowerPoint zu erstellen.

So erstellen Sie ein neues Projekt

  1. Erstellen Sie mithilfe der PowerPoint-Add-In-Projektvorlage ein PowerPoint-VSTO-Add-In-Projekt mit dem Namen MyAddIn. Weitere Informationen finden Sie unter How to: Create Office projects in Visual Studio.

    Visual Studio öffnet die Codedatei ThisAddIn.cs oder ThisAddIn.vb und fügt das MyAddIn-Projekt zu Projektmappen-Explorer hinzu.

Entwerfen der Benutzeroberfläche des benutzerdefinierten Aufgabenbereichs

Es gibt keinen visuellen Designer für benutzerdefinierte Aufgabenbereiche, Sie können aber dennoch ein Benutzersteuerelement mit dem gewünschten Layout entwerfen. Im weiteren Verlauf dieser exemplarischen Vorgehensweise fügen Sie dem benutzerdefinierten Aufgabenbereich das Benutzersteuerelement hinzu.

So entwerfen Sie die Benutzeroberfläche des benutzerdefinierten Aufgabenbereichs

  1. Klicken Sie im Menü Projekt auf Benutzersteuerelement hinzufügen.

  2. Ändern Sie im Dialogfeld Neues Element hinzufügen den Namen des Benutzersteuerelements in MyUserControl, und klicken Sie auf Hinzufügen.

    Das Benutzersteuerelement wird im Designer geöffnet.

  3. Ziehen Sie von der Registerkarte Allgemeine Steuerelemente der Toolboxein MonthCalendar -Steuerelement auf das Benutzersteuerelement.

    Wenn der Umfang des MonthCalendar -Steuerelements größer als die Entwurfsoberfläche des Benutzersteuerelements ist, passen Sie die Größe des Benutzersteuerelements an das MonthCalendar -Steuerelement an.

Automatisieren von PowerPoint aus dem benutzerdefinierten Aufgabenbereich

Mit dem VSTO-Add-In soll in der ersten Folie der aktiven Präsentation ein ausgewähltes Datum eingefügt werden. Verwenden Sie das DateChanged -Ereignis des Steuerelements, um das ausgewählte Datum bei jeder Änderung des Datums hinzuzufügen.

So automatisieren Sie PowerPoint über den benutzerdefinierten Aufgabenbereich

  1. Doppelklicken Sie im Designer auf das MonthCalendar -Steuerelement.

    Die Datei MyUserControl.cs oder MyUserControl.vb wird geöffnet, und ein Ereignishandler für das DateChanged -Ereignis wird erstellt.

  2. Fügen Sie den folgenden Code ganz oben in der Datei ein. Dieser Code erstellt Aliase für die Microsoft.Office.Core Namespaces und PowerPoint .

    using Office = Microsoft.Office.Core;
    using PowerPoint = Microsoft.Office.Interop.PowerPoint;
    
  3. Fügen Sie der MyUserControl -Klasse den folgenden Code hinzu. Dieser Code deklariert ein Shape-Objekt als Element von MyUserControl. Im folgenden Schritt verwenden Sie diese Form , um einer Folie in der aktiven Präsentation ein Textfeld hinzuzufügen.

    private PowerPoint.Shape textbox;
    
  4. Ersetzen Sie den monthCalendar1_DateChanged -Ereignishandler durch den folgenden Code. Mit diesem Code wird in die erste Folie in der aktiven Präsentation ein Textfeld eingefügt, in das anschließend das aktuell ausgewählte Datum eingefügt wird. Im Code wird mithilfe des Globals.ThisAddIn -Objekts auf das PowerPoint-Objektmodell zugegriffen.

    private void monthCalendar1_DateChanged(object sender, DateRangeEventArgs e)
    {
        try
        {
            if (textbox != null)
            {
                textbox.Delete();
            }
    
            PowerPoint.Slide slide =
                Globals.ThisAddIn.Application.ActivePresentation.Slides[1];
            textbox = slide.Shapes.AddTextbox(
                Office.MsoTextOrientation.msoTextOrientationHorizontal,
                50, 100, 600, 50);
            textbox.TextFrame.TextRange.Text = e.Start.ToLongDateString();
            textbox.TextFrame.TextRange.Font.Size = 48;
            textbox.TextFrame.TextRange.Font.Color.RGB =
                 Color.DarkViolet.ToArgb();
        }
        catch (Exception ex)
        {
            MessageBox.Show(ex.ToString());
        }
    }
    
  5. Klicken Sie im Projektmappen-Explorermit der rechten Maustaste auf das MyAddIn -Projekt, und klicken Sie dann auf Erstellen. Vergewissern Sie sich, dass das Projekt ohne Fehler erstellt wurde.

Anzeigen des benutzerdefinierten Aufgabenbereichs

Um den benutzerdefinierten Aufgabenbereich beim Starten des VSTO-Add-Ins anzuzeigen, fügen Sie dem Aufgabenbereich das Benutzersteuerelement im Startup -Ereignishandler des VSTO-Add-Ins hinzu.

So zeigen Sie den benutzerdefinierten Aufgabenbereich an

  1. Erweitern Sie PowerPointim Projektmappen-Explorer.

  2. Klicken Sie mit der rechten Maustaste auf ThisAddIn.cs oder ThisAddIn.vb , und klicken Sie auf Code anzeigen.

  3. Fügen Sie der ThisAddIn -Klasse den folgenden Code hinzu. Dieser Code deklariert Instanzen von MyUserControl und CustomTaskPane als Member der ThisAddIn -Klasse.

    private MyUserControl myUserControl1;
    private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;
    
  4. Ersetzen Sie den ThisAddIn_Startup -Ereignishandler durch den folgenden Code. Durch diesen Code wird ein neuer CustomTaskPane erstellt, indem der MyUserControl -Auflistung das CustomTaskPanes -Objekt hinzugefügt wird. Durch den Code wird auch der Aufgabenbereich angezeigt.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
    {
        myUserControl1 = new MyUserControl();
        myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "Calendar");
        myCustomTaskPane.Visible = true;
    }
    

Testen des Add-Ins

Wenn Sie das Projekt ausführen, wird PowerPoint geöffnet, und das VSTO-Add-In zeigt den benutzerdefinierten Aufgabenbereich an. Klicken Sie auf das MonthCalendar -Steuerelement, um den Code zu testen.

So testen Sie Ihr VSTO-Add-In

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

  2. Vergewissern Sie sich, dass der benutzerdefinierte Aufgabenbereich sichtbar ist.

  3. Klicken Sie im MonthCalendar -Steuerelement des Aufgabenbereichs auf ein Datum.

    Das Datum wird in die erste Folie der aktiven Präsentation eingefügt.

Nächste Schritte

Weitere Informationen über das Erstellen von benutzerdefinierten Aufgabenbereichen finden Sie in diesen Themen: