Sdílet prostřednictvím

Návod: Synchronizace vlastního podokna úloh s tlačítkem pásu karet

  • Článek

Tento názorný postup ukazuje, jak vytvořit vlastní podokno úloh, které můžou uživatelé skrýt nebo zobrazit kliknutím na přepínací tlačítko na pásu karet. Vždy byste měli vytvořit prvek uživatelského rozhraní (UI), například tlačítko, na které můžou uživatelé kliknout a zobrazit nebo skrýt vlastní podokno úloh, protože systém Microsoft Office aplikace neposkytují výchozí způsob zobrazení nebo skrytí vlastních podoken úloh.

Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO pro Outlook. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

I když tento názorný postup používá Konkrétně Excel, jsou koncepty, které názorný postup ukazuje, použitelné pro všechny aplikace, které jsou uvedeny výše.

Tento návod znázorňuje následující úlohy:

  • Návrh uživatelského rozhraní vlastního podokna úloh

  • Přidání přepínacího tlačítka na pás karet

  • Synchronizace přepínacího tlačítka s vlastním podoknem úloh

Poznámka:

Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí sady Visual Studio.

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

Vytvoření projektu doplňku

V tomto kroku vytvoříte projekt doplňku VSTO pro Excel.

Vytvoření nového projektu

  1. Vytvořte projekt doplňku aplikace Excel s názvem SynchronizeTaskPaneAndRibbon pomocí šablony projektu doplňku aplikace Excel. Další informace naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

    Visual Studio otevře soubor kódu ThisAddIn.cs nebo ThisAddIn.vb a přidá projekt SynchronizeTaskPaneAndRibbon do Průzkumník řešení.

Přidání přepínacího tlačítka na pás karet

Jedním z pokynů pro návrh aplikace Office lication je, že uživatelé by měli mít vždy kontrolu nad uživatelským rozhraním aplikace Office lication. Pokud chcete uživatelům povolit řízení vlastního podokna úloh, můžete přidat přepínací tlačítko pásu karet, které zobrazuje a skryje podokno úloh. Pokud chcete vytvořit přepínací tlačítko, přidejte do projektu položku pásu karet (Vizuální návrhář ). Návrhář vám pomůže přidat a umístit ovládací prvky, nastavit vlastnosti ovládacího prvku a zpracovat události ovládacích prvků. Další informace naleznete v tématu Návrhář pásu karet.

Přidání přepínacího tlačítka na pás karet

  1. V nabídce Projekt klepněte na tlačítko Přidat novou položku.

  2. V dialogovém okně Přidat novou položku vyberte pás karet (Vizuální návrhář).

  3. Změňte název nového pásu karet na ManageTaskPaneRibbon a klikněte na Přidat.

    Soubor ManageTaskPaneRibbon.cs nebo ManageTaskPaneRibbon.vb se otevře v Návrháři pásu karet a zobrazí výchozí kartu a skupinu.

  4. V Návrháři pásu karet klikněte na skupinu 1.

  5. V okně Vlastnosti nastavte vlastnost Popisek na Správce podokna úloh.

  6. Na kartě Ovládací prvky pásu karet Office na panelu nástrojů přetáhněte přepínací tlačítko do skupiny Správce podokna úloh.

  7. Klikněte na přepínací tlačítko1.

  8. V okně Vlastnosti nastavte vlastnost Popisek na Zobrazit podokno úloh.

Návrh uživatelského rozhraní vlastního podokna úloh

Pro vlastní podokna úloh neexistuje žádný vizuální návrhář, ale můžete navrhnout uživatelský ovládací prvek s požadovaným rozložením. Později v tomto názorném postupu přidáte uživatelský ovládací prvek do vlastního podokna úloh.

Návrh uživatelského rozhraní vlastního podokna úloh

  1. V nabídce Projekt klepněte na tlačítko Přidat uživatelský ovládací prvek.

  2. V dialogovém okně Přidat novou položku změňte název uživatelského ovládacího prvku na TaskPaneControl a klepněte na tlačítko Přidat.

    Uživatelský ovládací prvek se otevře v návrháři.

  3. Na kartě Běžné ovládací prvky panelu nástrojů přetáhněte ovládací prvek TextBox do uživatelského ovládacího prvku.

Vytvoření vlastního podokna úloh

Pokud chcete vytvořit vlastní podokno úloh při spuštění doplňku VSTO, přidejte uživatelský ovládací prvek do podokna úloh v Startup obslužné rutině události doplňku VSTO. Ve výchozím nastavení se vlastní podokno úloh nezobrazí. Později v tomto názorném postupu přidáte kód, který zobrazí nebo skryje podokno úloh, když uživatel klikne na přepínací tlačítko, které jste přidali na pás karet.

Vytvoření vlastního podokna úloh

  1. V Průzkumník řešení rozbalte Excel.

  2. Klepněte pravým tlačítkem myši ThisAddIn.cs nebo ThisAddIn.vb a klepněte na tlačítko Zobrazit kód.

  3. Do třídy ThisAddIn přidejte následující kód. Tento kód deklaruje instanci TaskPaneControl jako člena ThisAddIn.

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

  4. Obslužnou rutinu ThisAddIn_Startup události nahraďte následujícím kódem. Tento kód přidá TaskPaneControl objekt do CustomTaskPanes pole, ale nezobrazí vlastní podokno úloh (ve výchozím nastavení Visible je vlastnost CustomTaskPane třídy false). Kód Visual C# také připojí obslužnou rutinu VisibleChanged události k události.

    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. Do třídy přidejte následující metodu ThisAddIn . Tato metoda zpracovává VisibleChanged událost. Když uživatel zavře podokno úloh kliknutím na tlačítko Zavřít (X), tato metoda aktualizuje stav přepínacího tlačítka na pásu karet.

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

  6. Do třídy přidejte následující vlastnost ThisAddIn . Tato vlastnost zveřejňuje privátní taskPaneValue objekt jiným třídám. Později v tomto názorném postupu přidáte kód do MyRibbon třídy, která používá tuto vlastnost.

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

Skrytí a zobrazení vlastního podokna úloh pomocí přepínacího tlačítka

Posledním krokem je přidání kódu, který zobrazí nebo skryje vlastní podokno úloh, když uživatel klikne na přepínací tlačítko na pásu karet.

Zobrazení a skrytí vlastního podokna úloh pomocí přepínacího tlačítka

  1. V Návrháři pásu karet poklikejte na přepínací tlačítko Zobrazit podokno úloh.

    Visual Studio automaticky vygeneruje obslužnou rutinu události s názvem toggleButton1_Click, která zpracovává Click událost přepínacího tlačítka. Visual Studio také otevře soubor MyRibbon.cs nebo MyRibbon.vb v Editoru kódu.

  2. Obslužnou rutinu toggleButton1_Click události nahraďte následujícím kódem. Když uživatel klikne na přepínací tlačítko, zobrazí nebo skryje vlastní podokno úloh v závislosti na tom, jestli je tlačítko přepínacího tlačítka stisknuto nebo ne.

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

Otestování doplňku

Při spuštění projektu se Excel otevře bez zobrazení vlastního podokna úloh. Kliknutím na přepínací tlačítko na pásu karet otestujte kód.

Testování doplňku VSTO

  1. Stisknutím klávesy F5 spusťte projekt.

    Potvrďte, že se Excel otevře, a na pásu karet se zobrazí karta Doplňky .

  2. Klikněte na kartu Doplňky na pásu karet.

  3. Ve skupině Správce podokna úloh klikněte na přepínač Zobrazit podokno úloh.

    Po kliknutí na přepínací tlačítko ověřte, že je podokno úloh střídavě zobrazeno a skryto.

  4. Když je podokno úloh viditelné, klikněte v rohu podokna úloh na tlačítko Zavřít (X).

    Ověřte, že se tlačítko přepínacího tlačítka zdá být nestisknuté.

Další kroky

Další informace o vytváření vlastních podoken úloh najdete v těchto tématech:

Související obsah