CustomTaskPaneCollection – rozhraní

Článek
05/14/2013

Představuje kolekci vlastní podokna úloh v aplikaci 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žena na zadaný UserControl a se zadaným názvem.
	Add(UserControl, String, Object)	Vytvoří nový CustomTaskPane a přidá ji do aktuální CustomTaskPaneCollection.Vlastní podokno úloh je založena na zadaný UserControl, se zadaným názvem a je spojena s oknem zadanou aplikaci.
	BeginInit	Infrastruktura.
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (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 doplněk na aplikační úrovni vlastní podokno úloh do aplikace přidat, odebrat vlastní podokno úloh nebo získat přístup k existující vlastní podokno úloh.Přístup CustomTaskPaneCollection objekt, použijte CustomTaskPanes pole ThisAddIn tříd v projektu doplňku.Další informace naleznete v tématu Doplňky aplikace úroveň programování.

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 Visual Studio Tools pro přehled Runtime sady Office.

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 v projektech cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci 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) metoda.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);
}