Przewodnik: automatyzowanie aplikacji z niestandardowego okienka zadań

W tym przewodniku pokazano, jak utworzyć niestandardowe okienko zadań, które automatyzuje program PowerPoint. Niestandardowe okienko zadań wstawia daty do slajdu, gdy użytkownik kliknie kontrolkę MonthCalendar , która znajduje się w niestandardowym okienku zadań.

Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Mimo że ten przewodnik korzysta z programu PowerPoint specjalnie, koncepcje przedstawione w przewodniku mają zastosowanie do wszystkich aplikacji wymienionych powyżej.

W instruktażu przedstawiono następujące zagadnienia:

• Projektowanie interfejsu użytkownika w niestandardowym okienku zadań.

• Automatyzacja programu PowerPoint z poziomu niestandardowego okienka zadań.

• Wyświetlanie niestandardowego okienka zadań w programie PowerPoint.

Uwaga

Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE programu Visual Studio.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

• Edycja programu Visual Studio, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do tworzenia rozwiązań pakietu Office.

• Microsoft® PowerPoint® 2010 lub PowerPoint 2013 .

Tworzenie projektu dodatku

Pierwszym krokiem jest utworzenie projektu dodatku VSTO dla programu PowerPoint.

Aby utworzyć nowy projekt

1. Utwórz projekt dodatku VSTO programu PowerPoint o nazwie MyAddIn przy użyciu szablonu projektu dodatku programu PowerPoint. Aby uzyskać więcej informacji, zobacz How to: Create Office projects in Visual Studio (Jak tworzyć projekty pakietu Office w programie Visual Studio).

   Program Visual Studio otwiera plik kodu ThisAddIn.cs lub ThisAddIn.vb i dodaje projekt MyAddIn do Eksplorator rozwiązań.

Projektowanie interfejsu użytkownika w niestandardowym okienku zadań

Nie ma projektanta wizualnego dla niestandardowych okienek zadań, ale możesz zaprojektować kontrolkę użytkownika z żądanym układem. W dalszej części tego przewodnika dodasz kontrolkę użytkownika do niestandardowego okienka zadań.

Aby zaprojektować interfejs użytkownika niestandardowego okienka zadań

1. W menu Project (Projekt) kliknij pozycję Add User Control (Dodaj kontrolkę użytkownika).

2. W oknie dialogowym Dodawanie nowego elementu zmień nazwę kontrolki użytkownika na MyUserControl, a następnie kliknij przycisk Dodaj.

   Kontrolka użytkownika zostanie otwarta w projektancie.

3. Na karcie Wspólne kontrolki przybornika przeciągnij kontrolkę MonthCalendar do kontrolki użytkownika.

   Jeśli kontrolka MonthCalendar jest większa niż powierzchnia projektowa kontrolki użytkownika, zmień rozmiar kontrolki użytkownika, aby dopasować kontrolkę MonthCalendar .

Automatyzowanie programu PowerPoint z poziomu niestandardowego okienka zadań

Celem dodatku VSTO jest umieszczenie wybranej daty na pierwszym slajdzie aktywnej prezentacji. DateChanged Użyj zdarzenia kontrolki, aby dodać wybraną datę za każdym razem, gdy zmieni się.

Aby zautomatyzować program PowerPoint z poziomu niestandardowego okienka zadań

1. W projektancie kliknij dwukrotnie kontrolkę MonthCalendar .

   Zostanie otwarty plik MyUserControl.cs lub MyUserControl.vb , a zostanie utworzona procedura obsługi zdarzeń dla DateChanged zdarzenia.

2. Dodaj następujący kod na górze pliku. Ten kod tworzy aliasy dla Microsoft.Office.Core przestrzeni nazw i programu PowerPoint .

   C#

   using Office = Microsoft.Office.Core;
   using PowerPoint = Microsoft.Office.Interop.PowerPoint;
   

   VB

   Imports Office = Microsoft.Office.Core
   Imports PowerPoint = Microsoft.Office.Interop.PowerPoint
   

3. Dodaj poniższy kod do klasy MyUserControl. Ten kod deklaruje obiekt Shape jako element członkowski MyUserControl. W poniższym kroku użyjesz tego kształtu , aby dodać pole tekstowe do slajdu w aktywnej prezentacji.

   C#

   private PowerPoint.Shape textbox;
   

   VB

   Private TextBox As PowerPoint.Shape
   

4. Zastąp monthCalendar1_DateChanged program obsługi zdarzeń następującym kodem. Ten kod dodaje pole tekstowe do pierwszego slajdu w aktywnej prezentacji, a następnie dodaje aktualnie wybraną datę do pola tekstowego. Ten kod używa Globals.ThisAddIn obiektu w celu uzyskania dostępu do modelu obiektów programu PowerPoint.

   C#

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

   VB

   Private Sub MonthCalendar1_DateChanged( _
       ByVal sender As System.Object, _
       ByVal e As System.Windows.Forms.DateRangeEventArgs) _
       Handles MonthCalendar1.DateChanged
   
       Try
           If TextBox IsNot Nothing Then
               TextBox.Delete()
           End If
   
           Dim Slide As 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 = _
               System.Drawing.Color.DarkViolet.ToArgb()
   
       Catch ex As Exception
           System.Windows.Forms.MessageBox.Show(ex.ToString())
       End Try
   End Sub
   

5. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt MyAddIn, a następnie kliknij polecenie Kompiluj. Sprawdź, czy projekt jest kompilujący bez błędów.

Wyświetlanie niestandardowego okienka zadań

Aby wyświetlić niestandardowe okienko zadań po uruchomieniu dodatku VSTO, dodaj kontrolkę użytkownika do okienka zadań w Startup procedurze obsługi zdarzeń dodatku VSTO.

Aby wyświetlić niestandardowe okienko zadań

1. W Eksplorator rozwiązań rozwiń węzeł PowerPoint.

2. Kliknij prawym przyciskiem myszy pozycję ThisAddIn.cs lub ThisAddIn.vb i kliknij polecenie Wyświetl kod.

3. Dodaj poniższy kod do klasy ThisAddIn. Ten kod deklaruje wystąpienia MyUserControl klasy i CustomTaskPane jako elementy członkowskie ThisAddIn klasy.

   C#

   private MyUserControl myUserControl1;
   private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;
   

   VB

   Private myUserControl1 As MyUserControl
   Private myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane
   

4. Zastąp ThisAddIn_Startup program obsługi zdarzeń następującym kodem. Ten kod tworzy nowy CustomTaskPane obiekt przez dodanie MyUserControl obiektu do kolekcji CustomTaskPanes . Kod wyświetla również okienko zadań.

   C#

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

   VB

   Private Sub ThisAddIn_Startup(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles Me.Startup
   
       myUserControl1 = New MyUserControl
       myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "Calendar")
       myCustomTaskPane.Visible = True
   End Sub
   

Testowanie dodatku

Po uruchomieniu projektu program PowerPoint zostanie otwarty, a dodatek VSTO wyświetli niestandardowe okienko zadań. Kliknij kontrolkę, MonthCalendar aby przetestować kod.

Aby przetestować dodatek VSTO

1. Naciśnij klawisz F5 , aby uruchomić projekt.

2. Upewnij się, że niestandardowe okienko zadań jest widoczne.

3. Kliknij datę w kontrolce MonthCalendar w okienku zadań.

   Data zostanie wstawiona do pierwszego slajdu w aktywnej prezentacji.

Następne kroki

Więcej informacji na temat tworzenia niestandardowych okienek zadań można znaleźć w następujących tematach:

• Utwórz niestandardowe okienko zadań w dodatku VSTO dla innej aplikacji. Aby uzyskać więcej informacji na temat aplikacji obsługujących niestandardowe okienka zadań, zobacz Niestandardowe okienka zadań.

• Utwórz przycisk wstążki, którego można użyć do ukrycia lub wyświetlenia niestandardowego okienka zadań. Aby uzyskać więcej informacji, zobacz Przewodnik: Synchronizowanie niestandardowego okienka zadań z przyciskiem wstążki.

• Utwórz niestandardowe okienko zadań dla każdej wiadomości e-mail otwieranej w programie Outlook. Aby uzyskać więcej informacji, zobacz Przewodnik: wyświetlanie niestandardowych okienek zadań z wiadomościami e-mail w programie Outlook.

Powiązana zawartość

• Niestandardowe okienka zadań
• Instrukcje: dodawanie niestandardowego okienka zadań do aplikacji
• Przewodnik: synchronizowanie niestandardowego okienka zadań z przyciskiem wstążki
• Przewodnik: wyświetlanie niestandardowych okienek zadań z wiadomościami e-mail w programie Outlook