CustomTaskPaneCollection – rozhraní

Článek
01/03/2014

Představuje kolekci vlastní podokna úloh v aplikaci sady Microsoft Office.

Obor názvů: Microsoft.Office.Tools
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
<GuidAttribute("c3a84bf1-e95b-4d23-952d-59e35673958e")> _
Public Interface CustomTaskPaneCollection _
    Inherits IEnumerable(Of CustomTaskPane), IEnumerable, IDisposable

[GuidAttribute("c3a84bf1-e95b-4d23-952d-59e35673958e")]
public interface CustomTaskPaneCollection : IEnumerable<CustomTaskPane>, 
    IEnumerable, IDisposable

Typ CustomTaskPaneCollection zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Count	Získá číslo CustomTaskPane objekty v aktuální CustomTaskPaneCollection.
	Item	Získá CustomTaskPane na zadaný index.

Nahoru

Metody

	Název	Popis
	Add(UserControl, String)	Vytvoří nový CustomTaskPane a přidá ji do aktuální CustomTaskPaneCollection.Vlastní podokno úloh je založen na zadané UserControl a má zadaný název.
	Add(UserControl, String, Object)	Vytvoří nový CustomTaskPane a přidá ji do aktuální CustomTaskPaneCollection.Vlastní podokno úloh je založen na zadané UserControl, se zadaným názvem a je spojen s oknem zadané aplikace.
	BeginInit	Infrastruktura.
	Dispose	Provádí úkoly definované aplikací, které jsou spojeny s uvolněním nebo obnovením nespravovaných prostředků. (Zděděno z IDisposable.)
	EndInit	Infrastruktura.
	GetEnumerator	Vrátí hodnotu čítače výčtu, který prochází kolekce. (Zděděno z IEnumerable<CustomTaskPane>.)
	Remove	Odstraní zvolený CustomTaskPane z CustomTaskPaneCollection.
	RemoveAt	Odebere CustomTaskPane na zadaný index CustomTaskPaneCollection.

Nahoru

Poznámky

Použití CustomTaskPaneCollection objektu v úrovni aplikace doplňku aplikace do aplikace přidat vlastní podokno úloh, odebrat vlastní podokno úloh nebo přístup existující vlastní podokno úloh.Přístup CustomTaskPaneCollection objekt, použijte CustomTaskPanes pole ThisAddIn třídy v projektu doplněk.Další informace naleznete v tématu Programování doplňků na úrovni aplikace.

Podokna úloh jsou panely uživatelské rozhraní, které jsou obvykle ukotven k okraji okna aplikace.Další informace o tom, jak vytvořit vlastní podokna úloh, viz Vlastní podokna úloh.

[!POZNÁMKA]

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Přehled nástrojů Visual Studio Tools for Office runtime.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu projektů cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k sadě Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad kódu ukazuje, jak vytvořit vlastní podokno úloh pomocí Add(UserControl, String) metody.Příklad také používá vlastnosti CustomTaskPane objekt, který chcete změnit výchozí vzhled vlastní podokno úloh.Tento příklad kódu je součástí většího příkladu určeného pro CustomTaskPane.

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

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

    myUserControl1 = New MyUserControl()
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "New Task Pane")

    With myCustomTaskPane
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionFloating
        .Height = 500
        .Width = 500
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionRight
        .Width = 300
        .Visible = True
    End With
End Sub

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

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1,
        "New Task Pane");

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionFloating;
    myCustomTaskPane.Height = 500;
    myCustomTaskPane.Width = 500;

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionRight;
    myCustomTaskPane.Width = 300;

    myCustomTaskPane.Visible = true;
    myCustomTaskPane.DockPositionChanged +=
        new EventHandler(myCustomTaskPane_DockPositionChanged);
}