Udostępnij za pośrednictwem

Przewodnik: synchronizowanie niestandardowego okienka zadań z przyciskiem wstążki

  • Artykuł

W tym przewodniku pokazano, jak utworzyć niestandardowe okienko zadań, które użytkownicy mogą ukryć lub wyświetlić, klikając przycisk przełącznika na wstążce. Zawsze należy utworzyć element interfejsu użytkownika, taki jak przycisk, który użytkownicy mogą kliknąć, aby wyświetlić lub ukryć niestandardowe okienko zadań, ponieważ aplikacja pakietu Office licacje firmy Microsoft nie zapewniają domyślnego sposobu wyświetlania lub ukrywania niestandardowych okienek 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 Excel 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 niestandardowego okienka zadań.

  • Dodawanie przycisku przełącznika do wstążki.

  • Synchronizowanie przycisku przełącznika z niestandardowym okienkiem zadań.

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 Excel lub Microsoft Excel 2013 .

Tworzenie projektu dodatku

W tym kroku utworzysz projekt dodatku VSTO dla programu Excel.

Aby utworzyć nowy projekt

  1. Utwórz projekt dodatku programu Excel o nazwie SyncTaskPaneAndRibbon przy użyciu szablonu projektu dodatku programu Excel. 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 SyncTaskPaneAndRibbon do Eksplorator rozwiązań.

Dodawanie przycisku przełączania do wstążki

Jednym z wytycznych dotyczących projektowania aplikacja pakietu Office lication jest to, że użytkownicy powinni zawsze mieć kontrolę nad interfejsem użytkownika aplikacja pakietu Office lication. Aby umożliwić użytkownikom kontrolowanie niestandardowego okienka zadań, możesz dodać przycisk przełącznika wstążki, który pokazuje i ukrywa okienko zadań. Aby utworzyć przycisk przełącznika, dodaj element wstążki (Visual Projektant) do projektu. Projektant pomaga dodawać i umieszczać kontrolki, ustawiać właściwości kontrolki i obsługiwać zdarzenia sterowania. Aby uzyskać więcej informacji, zobacz Projektant wstążki.

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

  1. W menu Project (Projekt) kliknij pozycję Add New Item (Dodaj nowy element).

  2. W oknie dialogowym Dodawanie nowego elementu wybierz pozycję Wstążka (Visual Projektant).

  3. Zmień nazwę nowej wstążki na ManageTaskPaneRibbon, a następnie kliknij przycisk Dodaj.

    Plik ManageTaskPaneRibbon.cs lub ManageTaskPaneRibbon.vb zostanie otwarty w Projektant wstążki i wyświetli domyślną kartę i grupę.

  4. Na Projektant wstążki kliknij pozycję group1.

  5. W oknie Właściwości ustaw właściwość Etykieta na Menedżer okienka zadań.

  6. Na karcie Kontrolki wstążki pakietu Office przybornika przeciągnij przycisk ToggleButton do grupy Menedżer okienka zadań.

  7. Kliknij przycisk przełącznikButton1.

  8. W oknie Właściwości ustaw właściwość Etykieta na Pokaż okienko zadań.

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 TaskPaneControl, a następnie kliknij przycisk Dodaj.

    Kontrolka użytkownika zostanie otwarta w projektancie.

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

Tworzenie niestandardowego okienka zadań

Aby utworzyć niestandardowe okienko zadań po uruchomieniu dodatku VSTO, dodaj kontrolkę użytkownika do okienka zadań w Startup procedurze obsługi zdarzeń dodatku VSTO. Domyślnie niestandardowe okienko zadań nie będzie widoczne. W dalszej części tego przewodnika dodasz kod, który będzie wyświetlany lub ukrywany w okienku zadań po kliknięciu przycisku przełącznika dodanego do wstążki.

Aby utworzyć niestandardowe okienko zadań

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

  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ąpienie TaskPaneControl elementu jako element członkowski klasy ThisAddIn.

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

  4. Zastąp ThisAddIn_Startup program obsługi zdarzeń następującym kodem. Ten kod dodaje TaskPaneControl obiekt do CustomTaskPanes pola, ale nie wyświetla niestandardowego okienka zadań (domyślnie Visible właściwość CustomTaskPane klasy ma wartość false). Kod języka Visual C# dołącza również procedurę obsługi zdarzeń do VisibleChanged zdarzenia.

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

  5. Dodaj następującą metodę do ThisAddIn klasy . Ta metoda obsługuje VisibleChanged zdarzenie. Gdy użytkownik zamknie okienko zadań, klikając przycisk Zamknij (X), ta metoda aktualizuje stan przycisku przełącznika na wstążce.

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

  6. Dodaj następującą właściwość do ThisAddIn klasy. Ta właściwość uwidacznia obiekt prywatny taskPaneValue innym klasom. W dalszej części tego przewodnika dodasz kod do MyRibbon klasy, która używa tej właściwości.

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

Ukryj i pokaż niestandardowe okienko zadań za pomocą przycisku przełącznika

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

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

  1. Na Projektant wstążki kliknij dwukrotnie przycisk Pokaż okienko zadań.

    Program Visual Studio automatycznie generuje program obsługi zdarzeń o nazwie toggleButton1_Click, który obsługuje Click zdarzenie przycisku przełącznika. Program Visual Studio otwiera również plik MyRibbon.cs lub MyRibbon.vb w Edytorze kodu.

  2. Zastąp toggleButton1_Click program obsługi zdarzeń następującym kodem. Gdy użytkownik kliknie przycisk przełącznika, ten kod wyświetla lub ukrywa niestandardowe okienko zadań, w zależności od tego, czy przycisk przełącznika jest naciśnięty, czy nie jest naciśnięty.

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

Testowanie dodatku

Po uruchomieniu projektu program Excel zostanie otwarty bez wyświetlania niestandardowego okienka zadań. Kliknij przycisk przełącznika na wstążce, aby przetestować kod.

Aby przetestować dodatek VSTO

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

    Upewnij się, że program Excel zostanie otwarty, a karta Dodatki zostanie wyświetlona na wstążce.

  2. Kliknij kartę Dodatki na wstążce.

  3. W grupie Menedżer okienka zadań kliknij przycisk Pokaż okienko zadań.

    Sprawdź, czy okienko zadań jest wyświetlane i ukryte po kliknięciu przycisku przełącznika.

  4. Gdy okienko zadań jest widoczne, kliknij przycisk Zamknij (X) w rogu okienka zadań.

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

Następne kroki

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

Powiązana zawartość