Názorný postup: Synchronizace s pásu tlačítko Vlastní podokno úloh

Článek
03/04/2013

Tento návod ukazuje, jak vytvořit vlastní podokno úloh, který uživatelé můžete zobrazit nebo skrýt klepnutím na tlačítko Přepnout na pásu karet.Vždy byste měli vytvořit prvek uživatelského rozhraní (UI), například tlačítko, které mohou uživatelé klepnout a zobrazit nebo skrýt své vlastní podokno úloh, protože aplikace Microsoft Office neposkytují výchozí způsob, jakým uživatelé zobrazit nebo skrýt vlastní podokna úloh.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v aplikacích Outlook 2013 a Outlook 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Přestože tento návod používá aplikace Excel konkrétně, koncepty prokázat návodu jsou použitelné pro aplikace, které jsou uvedeny výše.

Tento návod ilustruje následující úkoly:

Návrh uživatelského rozhraní pro vlastní podokno úloh.
Přidání přepínací tlačítko na pásu karet.
Přepínací tlačítko synchronizace s vlastní podokno úloh.

[!POZNÁMKA]

Váš počítač může zobrazit jiné názvy nebo umístění pro některé prvky uživatelského rozhraní sady Visual Studio v následujících pokynech.Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením.Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

Edice sady Visual Studio 2012, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace naleznete v tématu [Konfigurace počítače vyvinout řešení Office](bb398242\(v=vs.110\).md).

Microsoft Excel 2010 nebo Microsoft Excel 2013.

Vytváření projektu doplněk

V tomto kroku vytvoříte projekt doplněk aplikace Excel.

Vytvoření nového projektu

Vytvoření projektu aplikace Excel s názvem SynchronizeTaskPaneAndRibbon pomocí šablony projektu doplněk aplikace Excel.Další informace naleznete v tématu Jak: vytvoření Office projekty v aplikaci Visual Studio.

Visual StudioOtevře ThisAddIn.cs nebo ThisAddIn.vb soubor kódu a přidá SynchronizeTaskPaneAndRibbon projektu Průzkumníku.

Přidání přepínací tlačítko na pásu karet

Pokyny pro návrh aplikací sady Office je uživatelé by měli mít vždy prvek uživatelského rozhraní aplikace Office.Povolit uživatelům ovládat vlastní podokno úloh, můžete přidat pásu přepínací tlačítko, které zobrazí a skryje podokno úloh.Vytvořit přepínací tlačítko, přidejte pásu karet (vizuální návrhář) položky k projektu.Návrhář pomáhá přidat umístit ovládací prvky, nastavte vlastnosti ovládacího prvku a zpracovat události ovládacího prvku.Další informace naleznete v tématu Návrhář pásu karet.

Přepínací tlačítko Přidat na pás karet

V nabídce Projekt klikněte na příkaz Přidat novou položku.
V Přidat novou položku dialogovém pásu karet (vizuální návrhář).
Změňte název nové pásu karet na ManageTaskPaneRibbona na Přidat.

ManageTaskPaneRibbon.cs nebo ManageTaskPaneRibbon.vb soubor se otevře v Návrháři pásu karet a zobrazí výchozí kartu a skupiny.
Návrhář pásu karet klepněte na tlačítko skupina1.
V Vlastnosti okno, nastavit štítek vlastnost do Správce podokna úloh.
Z Ovládací prvky pásu karet Office kartě nástrojů, přetáhněte ToggleButton na Správce podokna úloh skupiny.
Klepněte na toggleButton1.
V Vlastnosti okno, nastavit štítek vlastnost zobrazit podokna úloh.

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

Neexistuje žádný vizuální návrhář pro vlastní podokna úloh, ale můžete navrhnout uživatelský ovládací prvek požadované rozložení.Dále v tomto návodu přidáte uživatelský ovládací prvek vlastní podokno úloh.

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

Na projektu nabídky, klepněte na Přidat uživatelský ovládací prvek.
V Přidat novou položku dialogovém okně změnit název uživatelského ovládacího prvku TaskPaneControla klepněte na tlačítko Přidat.

Uživatelský ovládací prvek se otevře v návrháři.
Z Běžné ovládací prvky kartě nástrojů, přetáhněte TextBox řízení uživatelského ovládacího prvku.

Vytvoření vlastní podokno úloh

Vytvořit vlastní podokno úloh při spuštění doplňku, přidejte uživatelský ovládací prvek podokno úloh v Startup obslužné rutiny v.Ve výchozím nastavení vlastní podokno úloh nebude viditelný.Dále v tomto návodu přidáte kód, který zobrazíte nebo skryjete podokno úloh po klepnutí na přepínací tlačítko přidané do pásu karet.

Chcete-li vytvořit vlastní podokno úloh

V Průzkumníku, rozbalte Excel.
Klepněte pravým tlačítkem ThisAddIn.cs nebo ThisAddIn.vb a na Zobrazení kódu.

Přidejte následující kód do třídy ThisAddIn.Tento kód deklaruje instanci TaskPaneControl jako člen ThisAddIn.

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

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

Nahradit ThisAddIn_Startup obslužnou rutinu následujícím kódem.Tento kód přidá TaskPaneControl objektu CustomTaskPanes pole, ale nezobrazí vlastní podokno úloh (standardně Visible vlastnost CustomTaskPane je třída false).Kód jazyka Visual C# také připojí obslužnou rutinu události a VisibleChanged události.

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

Přidejte následující metodu ThisAddIn třídy.Tato metoda zajišťuje VisibleChanged události.Když uživatel zavře podokno úloh klepnutím Zavřít tlačítko (X), tato metoda aktualizace stavu přepínací tlačítko na pásu karet.

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

Přidat následující vlastnosti ThisAddIn třídy.Tato vlastnost poskytuje soukromé myCustomTaskPane1 objekt do jiné třídy.Dále v tomto návodu přidáte kód, který MyRibbon třída, která používá tuto vlastnost.

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

Skrytí a zobrazení vlastní podokno úloh pomocí přepínací tlačítko

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

Zobrazení a skrytí vlastní podokno úloh pomocí přepínací tlačítko

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

Visual Studio automaticky generuje obslužnou rutinu s názvem toggleButton1_Click, která zpracovává Click události přepínací tlačítko.Visual Studio otevře také MyRibbon.cs nebo MyRibbon.vb souboru v editoru kódu.

Nahradit toggleButton1_Click obslužnou rutinu následujícím kódem.Když uživatel klikne na tlačítko Přepnout, tento kód zobrazí nebo skryje vlastní podokno úloh podle toho, zda je přepínací tlačítko stisknuté nebo není stisknuto.

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

Testování doplněk

Při spuštění projektu otevře aplikace Excel bez zobrazení vlastní podokno úloh.Klepněte na tlačítko Přepnout na pásu karet k testování kódu.

Testování doplněk

Stisknutím klávesy F5 spustit projektu.

Potvrďte, že aplikace Excel otevře a Doplňky karta se zobrazí na pásu karet.
Klepněte Doplňky kartu na pásu karet.
V Správce podokna úloh skupinu, klepněte Zobrazit podokno úloh přepínací tlačítko.

Ověřte střídavě zobrazených a skrytých klepnete na tlačítko Přepnout podokno úloh.
Při podokno úloh je zobrazen, klepněte Zavřít v podokno úloh rohu tlačítko (X).

Ověřte přepínací tlačítko zdánlivě nebylo stisknuté.

Další kroky

Další informace o tom, jak vytvořit vlastní podokna úloh z těchto témat:

Vytvořte vlastní podokno úloh v přidat v jiné aplikaci.Další informace o aplikacích, které podporují vlastní podokna úloh, viz Vlastní podokna úloh.
Automatizovat aplikaci z vlastní podokno úloh.Další informace naleznete v tématu Názorný postup: Automatizace aplikace z podokna úloh Vlastní.
Vytvořte vlastní podokno úloh každé e-mailové zprávy, který je otevřen v aplikaci Outlook.Další informace naleznete v tématu Názorný postup: Zobrazení podokna úloh vlastní s e-mailové zprávy v aplikaci Outlook.