Wskazówka: synchronizacja niestandardowego okienka zadań z przyciskiem wstążki

Artykuł
06/10/2015

Ten instruktaż przedstawia sposób tworzenia niestandardowych okienko zadań, że użytkowników można ukryć lub wyświetlić, klikając przycisk Przełącz na Wstążce.Należy zawsze utworzyć elementu interfejsu użytkownika, takie jak przycisk, który użytkownicy mogą kliknąć aby wyświetlić lub ukryć swoje niestandardowe okienko zadań, ponieważ aplikacje Microsoft Office umożliwiają domyślną dla użytkowników pokazać lub ukryć niestandardowe okienka zadań.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie aplikacji obsługiwanych w programach Outlook 2013 i Outlook 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

Chociaż w tym instruktażu specjalnie używa programu Excel, pojęcia świadczy instruktażu są stosowane do wszystkie aplikacje, które są wymienione powyżej.

W tym instruktażu przedstawiono następujące zadania:

Projektowanie UI okienko zadań niestandardowe.
Dodawanie przycisku przełącznika na Wstążce.
Synchronizowanie przycisk przełącznika z niestandardowego okienko zadań.

[!UWAGA]

Komputer może pokazać różne nazwy lub lokalizacje dla niektórych użytkowników programu Visual Studio elementów interfejsu w poniższych instrukcji.Wydanie programu Visual Studio, że masz i ustawienia, które możesz używać określenia tych elementów.Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Edycja programu Visual Studio 2013, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do opracowywania rozwiązań pakietu Office.
Program Microsoft Excel 2010 lub Microsoft Excel 2013.

Tworzenie projektu w

W tym kroku utworzysz projektu dodatek dla programu Excel.

Aby utworzyć nowy projekt

Tworzenie projektu w programie Excel o nazwie SynchronizeTaskPaneAndRibbon, przy użyciu szablonu projektu-w programie Excel.Aby uzyskać więcej informacji, zobacz Porady: tworzenie projektów Office w Visual Studio.

Visual StudioOtwiera ThisAddIn.cs lub ThisAddIn.vb kod pliku i dodaje SynchronizeTaskPaneAndRibbon projekt Solution Explorer.

Dodawanie przycisku Przełącz do wstążki

Jednym z wytyczne dotyczące projektowania aplikacji pakietu Office jest to, że użytkownicy powinni mieć zawsze kontrolę nad interfejsu użytkownika aplikacji pakietu Office.Aby umożliwić użytkownikom kontrolować okienko zadań niestandardowe, można dodać przycisk przełącznika wstążki, który pokazuje i ukrywa okienko zadań.Aby utworzyć przycisk przełącznika, należy dodać wstążki (Visual Designer) element do projektu.Projektant pomaga dodać i ustawianie formantów, ustaw właściwości formantu i obsługi zdarzeń dla formantu.Aby uzyskać więcej informacji, zobacz Projektant wstążki.

Aby dodać przycisk przełącznika do wstążki

Na Projekt menu, kliknij przycisk Dodaj nowy element.
W Dodaj nowy element okno dialogowe, wybierz wstążki (Visual Designer).
Zmień nazwę nowej taśmy do ManageTaskPaneRibboni kliknij przycisk Dodaj.

ManageTaskPaneRibbon.cs lub ManageTaskPaneRibbon.vb plik zostanie otwarty w Projektancie Wstążki i wyświetla domyślną kartę i grupy.
W Projektancie Wstążki kliknij grupa1.
W Właściwości okno, ustawić etykiety właściwość Menedżer okienka zadań.
Z Formanty wstążki Office karta Przybornik, przeciągnij ToggleButton na Menedżer okienka zadań grupy.
Kliknij przycisk toggleButton1.
W Właściwości okno, ustawić etykiety właściwość, aby wyświetlić okienko zadań.

Projektowanie interfejsu użytkownika niestandardowego okienka zadań

Brak projektanta wizualne dla niestandardowych okienek zadań, ale można zaprojektować formant użytkownika z żądany układ.Później w tym instruktażu dodasz formant użytkownika do okienko zadań niestandardowe.

Aby zaprojektować interfejs użytkownika niestandardowego okienko zadań

Na Projekt menu, kliknij przycisk Dodać formant użytkownika.
W Dodaj nowy element okno dialogowe pole, Zmień nazwę formantu, aby TaskPaneControli kliknij przycisk Dodaj.

Kontrola użytkownika zostanie otwarty w projektancie.
Z Wspólnej kontroli karta Przybornik, przeciągnij pole tekstowe kontroli do kontroli użytkownika.

Tworzenie niestandardowego okienka zadań

Do tworzenia niestandardowych okienko zadań po uruchomieniu dodatku, należy dodać formant użytkownika do okienko zadań w Startup obsługi zdarzeń z dodatku.Domyślnie okienko zadań niestandardowe nie będą widoczne.W dalszej części tej procedury należy dodać kod, który spowoduje wyświetlenie lub ukrycie okienko zadań, gdy użytkownik kliknie przycisk przełącznika, dodane do wstążki.

Aby utworzyć niestandardowe okienko zadań

W Solution Explorer, rozwiń węzeł Excel.
Kliknij prawym przyciskiem myszy ThisAddIn.cs lub ThisAddIn.vb i kliknij przycisk Widok Kod.

Dodaj następujący kod do ThisAddIn klasy.Ten kod deklaruje instancję TaskPaneControl jako członek ThisAddIn.

Private taskPaneControl1 As TaskPaneControl
Private WithEvents taskPaneValue As Microsoft.Office.Tools.CustomTaskPane

private TaskPaneControl taskPaneControl1;
private Microsoft.Office.Tools.CustomTaskPane taskPaneValue;

Zamień ThisAddIn_Startup obsługi zdarzeń z następującego kodu.Dodaje ten kod TaskPaneControl obiekt do CustomTaskPanes pola, ale nie wyświetla niestandardowych okienko zadań (domyślnie, Visible właściwość CustomTaskPane klasy jest false).Kod C# przywiązuje także obsługa zdarzeń do VisibleChanged zdarzenie.

Private Sub ThisAddIn_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    taskPaneControl1 = New TaskPaneControl()
    taskPaneValue = Me.CustomTaskPanes.Add( _
        taskPaneControl1, "MyCustomTaskPane")
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    taskPaneControl1 = new TaskPaneControl();
    taskPaneValue = this.CustomTaskPanes.Add(
        taskPaneControl1, "MyCustomTaskPane");
    taskPaneValue.VisibleChanged +=
        new EventHandler(taskPaneValue_VisibleChanged);
}

Dodaj następującą metodę do ThisAddIn klasy.Ta metoda obsługuje VisibleChanged zdarzenie.Kiedy użytkownik zamyka klikając okienko zadań Zamknij przycisk (X), to aktualizacje metoda stan Przełącz przycisk na Wstążce.

Private Sub taskPaneValue_VisibleChanged(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles taskPaneValue.VisibleChanged

    Globals.Ribbons.ManageTaskPaneRibbon.ToggleButton1.Checked = taskPaneValue.Visible
End Sub

private void taskPaneValue_VisibleChanged(object sender, System.EventArgs e)
{
    Globals.Ribbons.ManageTaskPaneRibbon.toggleButton1.Checked = 
        taskPaneValue.Visible;
}

Dodaj następujące właściwości, aby ThisAddIn klasy.Ta właściwość udostępnia prywatnego myCustomTaskPane1 obiekt do innych klas.W dalszej części tej procedury, należy dodać kod do MyRibbon klasy, która używa tej właściwości.

Public ReadOnly Property TaskPane() As Microsoft.Office.Tools.CustomTaskPane
    Get 
        Return taskPaneValue
    End Get 
End Property

public Microsoft.Office.Tools.CustomTaskPane TaskPane
{
    get
    {
        return taskPaneValue;
    }
}

Ukrywanie i pokazywanie niestandardowe okienko zadań przy użyciu przycisku przełącznika

Ostatnim krokiem jest dodanie kod, który wyświetla lub ukrywa niestandardowe okienko zadań, gdy użytkownik kliknie przycisk przełącznika na Wstążce.

Aby wyświetlić i ukryć okienko zadań niestandardowych za pomocą przycisku przełączania

W Projektancie wstążki, kliknij dwukrotnie Pokaż okienko zadań przycisk przełącznika.

Visual Studio generuje automatycznie program obsługi zdarzeń o nazwie toggleButton1_Click, dojścia Click przycisku przełącznika.Otwiera również Visual Studio MyRibbon.cs lub MyRibbon.vb plik w edytorze kodu.

Zamień toggleButton1_Click obsługi zdarzeń z następującego kodu.Gdy użytkownik kliknie przycisk przełącznika, ten kod wyświetla lub ukrywa okienko zadań niestandardowe, w zależności od tego, czy wciśnięty lub nie jest wciśnięty przycisk przełącznika.

Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles ToggleButton1.Click

    Globals.ThisAddIn.TaskPane.Visible = _
        TryCast(sender, Microsoft.Office.Tools.Ribbon.RibbonToggleButton).Checked
End Sub

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisAddIn.TaskPane.Visible = ((RibbonToggleButton)sender).Checked;
}

Badania-dodatek

Po uruchomieniu projektu, program Excel otwiera się bez wyświetlania niestandardowej okienko zadań.Kliknij przycisk Przełącz na Wstążce w celu przetestowania kodu.

Aby przetestować dodatek

Naciśnij klawisz F5, aby uruchomić projekt.

Potwierdź, że program Excel zostanie otwarty i Dodatki pojawi się karta na Wstążce.
Kliknij przycisk Dodatki karta na Wstążce.
W Menedżer okienka zadań grupy, kliknij przycisk Pokaż okienko zadań przycisk przełącznika.

Sprawdź, czy okienko zadań jest na przemian wyświetlone i ukryte po kliknięciu przycisku przełącznika.
Gdy okienko zadań jest widoczny, kliknij przycisk Zamknij przycisk (X) w rogu okienko zadań.

Sprawdź, czy przycisk przełącznika pojawia się nie być wciśnięty.

Następne kroki

Można uzyskać więcej informacji na temat tworzenia niestandardowych okienek zadań z tych tematów:

Tworzenie niestandardowych okienko zadań w dodatku do innej aplikacji.Aby uzyskać więcej informacji na temat aplikacji, które obsługują niestandardowe okienka zadań, zobacz Niestandardowe okienka zadań.
Automatyzacja aplikacji z okienko zadań niestandardowe.Aby uzyskać więcej informacji, zobacz Wskazówki: automatyzacja aplikacji z niestandardowego okienka zadań.
Tworzenie niestandardowych okienko zadań dla każdej wiadomości e-mail, który jest otwarty w programie Outlook.Aby uzyskać więcej informacji, zobacz Wskazówki: wyświetlanie niestandardowych okienek zadań z wiadomościami e-mail w programie Outlook.