CustomTaskPaneCollection.Add – metoda (UserControl, String, Object)

Článek
08/11/2011

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.

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

Syntaxe

'Deklarace
Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane

CustomTaskPane Add(
    UserControl control,
    string title,
    Object window
)

Parametry

control
Typ: System.Windows.Forms.UserControl
A UserControl , poskytuje uživatel rozhraní pro nové úloha podokno.

title
Typ: System.String
Text zobrazený v nové úlohapodokno záhlaví .

window
Typ: System.Object
objekt , který představujeokno aplikacepřidružit novou úlohavlastnípodokno s.

Vrácená hodnota

Typ: Microsoft.Office.Tools.CustomTaskPane
A CustomTaskPane , představuje nové vlastní úloha podokno.

Výjimky

Výjimka	Podmínka
ArgumentNullException	controlor title is nullodkaz Null (Nothing v jazyce Visual Basic).
ObjectDisposedException	Dispose()Na již byla volánametoda CustomTaskPaneCollection.

Poznámky

Použít této metoda vytvořit nový CustomTaskPane je spojeno s konkrétní aplikace okno. Tato metoda je užitečná, pokud chcete vytvořit vlastní úloha podokna viditelné více inspektoři nebo programu Průzkumník v aplikaci Outlook nebo více dokumentů aplikace Word nebo aplikace InfoPath. Další informace naleznete v tématu Managing Custom Task Panes in Multiple Application Windows.

Typ window parametr závisí na aplikace. V následující tabulce jsou uvedeny platný typy window parametr.

Aplikace	Typ parametru
Word	Microsoft.Office.Interop.Word.Window
Excel	Microsoft.Office.Interop.Excel.Window
PowerPoint	Microsoft.Office.Interop.PowerPoint.DocumentWindow
InfoPath	Microsoft.Office.Interop.InfoPath.WindowObject
Outlook	Microsoft.Office.Interop.Outlook.Explorer -nebo- Microsoft.Office.Interop.Outlook.Inspector

Ačkoli CustomTaskPaneCollection je kolekce CustomTaskPane objekty, Add metoda přijímá UserControl objekty namísto CustomTaskPane objektů. Další informace naleznete v tématu Custom Task Panes Overview.

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.