Udostępnij za pośrednictwem

Metoda CustomTaskPaneCollection.Add — (UserControl, String)

  • Artykuł

Tworzy nową CustomTaskPane i dodaje go do bieżącego CustomTaskPaneCollection.Niestandardowe okienko zadań jest oparty na określonym UserControl i ma określony tytuł.

Przestrzeń nazw:  Microsoft.Office.Tools
Zestaw:  Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
Function Add ( _
    control As UserControl, _
    title As String _
) As CustomTaskPane

CustomTaskPane Add(
    UserControl control,
    string title
)

Parametry

  • title
    Typ: System.String
    Tekst wyświetlany na pasku tytułu nowe niestandardowe okienko zadań.

Wartość zwracana

Typ: Microsoft.Office.Tools.CustomTaskPane
A CustomTaskPane , oznaczającą nowe niestandardowe okienko zadań.

Wyjątki

Wyjątek Warunek
ArgumentNullException

controlor title is nullodwołanie o wartości null (Nothing w języku Visual Basic).
ObjectDisposedException

Dispose Metoda została już wywołana dla CustomTaskPaneCollection.

Uwagi

Metoda ta pozwala utworzyć nowy CustomTaskPane skojarzonego z aktywnego okna aplikacji Microsoft Office.

Chociaż CustomTaskPaneCollection obiektu to kolekcja CustomTaskPane obiektów, Add metoda przyjmuje UserControl obiektów, a nie CustomTaskPane obiektów.Aby uzyskać więcej informacji, zobacz Niestandardowe okienka zadań.

Jeśli chcesz określić pewien szczególny okno i skojarzy z nim niestandardowe okienko zadań, należy użyć Add(UserControl, String, Object) metoda.

Przykłady

Poniższy przykład kodu demonstruje, jak utworzyć niestandardowe okienko zadań przy użyciu Add(UserControl, String) metoda.W przykładzie użyto również właściwości CustomTaskPane obiekt, aby modyfikować domyślnego wyglądu niestandardowe okienko zadań.Ten przykład kodu jest częścią większy przykład przewidziane 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);
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

CustomTaskPaneCollection Interfejs

Przeciążenie Add

Przestrzeń nazw Microsoft.Office.Tools