Udostępnij za pośrednictwem

Metoda CustomTaskPaneCollection.Add — (UserControl, String)

  • Artykuł

Tworzy nowy CustomTaskPane i dodaje go do bieżącego CustomTaskPaneCollection.Niestandardowe okienko zadań jest oparta 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 reprezentująca nowe niestandardowe okienko zadań.

Wyjątki

Wyjątek Warunek
ArgumentNullException

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

Dispose Została już wywołana metoda na CustomTaskPaneCollection.

Uwagi

Ta metoda służy do tworzenia nowego CustomTaskPane skojarzonego z aktywnego okna aplikacji pakietu Microsoft Office.

Chociaż CustomTaskPaneCollection obiektu jest zbiorem 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 nią niestandardowe okienko zadań, należy użyć Add(UserControl, String, Object) metody.

Przykłady

Poniższy przykład kodu pokazuje, jak utworzyć niestandardowe okienko zadań za pomocą Add(UserControl, String) metody.W przykładzie użyto również właściwości CustomTaskPane obiekt, aby modyfikować domyślnego wyglądu niestandardowe okienko zadań.Poniższy 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