CustomTaskPaneCollection – rozhraní

Článek
08/11/2011

Představuje kolekce podoken úloha vaplikacesady systém 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ává CustomTaskPane na zadaný index.

Na začátek

Metody

	Název	Popis
	Add(UserControl, String)	Vytvoří nový CustomTaskPane a přidá ji do aktuální CustomTaskPaneCollection.Vlastní úloha podokno je založena na určeném UserControl a má zadaného názvu.
	Add(UserControl, String, Object)	Vytvoří nový CustomTaskPane a přidá ji do aktuální CustomTaskPaneCollection.Vlastní úloha podokno je založena na určeném UserControl, nemá zadaný název a je přidružena k zadané aplikace okno.
	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()	Čítač výčtu, iteruje kolekce vrátí. (Zděděno z IEnumerable<CustomTaskPane>.)
	GetEnumerator()	Čítač výčtu, iteruje kolekce vrátí. (Zděděno z IEnumerable.)
	Remove	Odebere zadaný CustomTaskPane z CustomTaskPaneCollection.
	RemoveAt	Odebere CustomTaskPane na zadaný index CustomTaskPaneCollection.

Na začátek

Poznámky

Použít CustomTaskPaneCollection objekt v aplikace-úroveň doplněk přidat vlastní úloha podokno aplikaceodebrat vlastní úloha podoknonebo existující vlastní úloha podoknopřístup. Přístup CustomTaskPaneCollection objekt, použijte CustomTaskPanes pole ThisAddIn třída doplněk projekt. Další informace naleznete v tématu Programming Application-Level Add-Ins.

Podokna úloh jsou panely uživatelrozhraní , které obvykle ukotven k okrajiokno aplikace. Další informace o tom, jak vytvořit vlastní úloha podokna naleznete Custom Task Panes Overview.

Poznámka

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

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí 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í úloha podokno pomocí Add(UserControl, String) metoda. Příklad používá také vlastnosti CustomTaskPane objekt upravit výchozí vzhled úloha podokno. Příklad kódu je součástí větší příklad k 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);
}