Metoda ToolBoxItems.Add —

  • Artykuł

Tworzy nowy element i dodaje go do Przybornik.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
Function Add ( _
    Name As String, _
    Data As Object, _
    Format As vsToolBoxItemFormat _
) As ToolBoxItem

ToolBoxItem Add(
    string Name,
    Object Data,
    vsToolBoxItemFormat Format
)

ToolBoxItem^ Add(
    [InAttribute] String^ Name, 
    [InAttribute] Object^ Data, 
    [InAttribute] vsToolBoxItemFormat Format
)

abstract Add : 
        Name:string * 
        Data:Object * 
        Format:vsToolBoxItemFormat -> ToolBoxItem

function Add(
    Name : String, 
    Data : Object, 
    Format : vsToolBoxItemFormat
) : ToolBoxItem

Parametry

  • Name
    Typ: String

    Wymagany.Ciąg reprezentujący podpis nowego elementu.

  • Data
    Typ: Object

    Wymagany.Wariant reprezentujących ciąg, formant lub inny element do dodania do Przybornik.

Wartość zwracana

Typ: EnvDTE.ToolBoxItem
Obiekt ToolBoxItem.

Uwagi

Ta metoda nie powiedzie się, jeśli ToolBoxItems należy kolekcja ToolBoxTab obiekt, który został usunięty lub jeśli użytkownik spróbuje dodać kartę z nazwą już istnieje.

Dla Data argument, Visual C++ użytkownicy mogą przenosić IUnknown IDataObject.

Podczas dodawania zespół Format typu vsToolBoxItemFormatDotNETComponent, wartość przekazywana do Data parametr może być w jednym z następujących formatów:

  • <AssemblyPath>— W przypadku gdy "< AssemblyPath >" jest ścieżka i nazwa, wskazując zestawu zarządzanych, takich jak C:\Libraries\MyAssembly.dll.Użycie tego formatu wszystkich klas w ciągu.Biblioteki DLL są dodawane do Przybornik.

  • <AssemblyNameInTheGAC>— Jedną klasę wymienionych jako odwołanie kwalifikowana zestawu.Pojedynczy klas mogą być dodawane jako formanty, o ile są one odniesienia do złożenia, który znajduje się w globalna pamięć podręczna zestawów (GAC), takie jak: WindowControlLibrary1.UserControl1, WindowControlLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<Your Token>. (Należy zastąpić <Your Token> z sieci token klucza publicznego, który jest zobowiązany do dodawania użytkownika zestawu w GAC.)

Przykłady

Poniższy przykład pokazuje, jak dodać dokument tekstowy do Przybornik:

Sub ToolBoxAddExample1()
    ' This adds a Text item to the first tab of the ToolBox.
    ' Define the variables and create an object reference to the IDE's  
    ' ToolBox object.
    Dim win As Window = DTE.Windows.Item(Constants.vsWindowKindToolbox)
    Dim tlbox As ToolBox = win.Object
    Dim tbxTabs As ToolBoxTabs

    ' Create an object reference to the ToolBoxTabs object.
    tbxTabs = tlbox.ToolBoxTabs

    ' Add a new Text item to the first tab in the ToolBox.
    tbxTabs.Item(1).ToolBoxItems.Add("New Text Item", "Some text to _
    add to the document.", vsToolBoxItemFormat.vsToolBoxItemFormatText)
End Sub

Poniższy przykład pokazuje, jak dodać składnik .NET do Przybornik przy użyciu ścieżki do pliku.Składnik do dodania musi być .NET kontroli, takich jak Visual Basic składnik Biblioteka formantów systemu Windows.

Sub ToolBoxItemAddExample2()
    Try
        Dim tlBox As ToolBox
        tlBox = CType(DTE.Windows.Item(Constants. _
        vsWindowKindToolbox).Object, EnvDTE.ToolBox)
        ' Create a new tab called "My Controls."
        Dim tlBoxTab As ToolBoxTab = tlBox.ToolBoxTabs. _
        Add("My Controls")
        ' Set focus to the new Toolbox tab.
        tlBoxTab.Activate()
        ' Add a .NET control as a new control in the new ToolBox tab. 
        ' The constant "vsToolBoxItemFormatDotNETComponent" alerts the 
        ' ToolBox to the type of control you are adding.
        tlBoxTab.ToolBoxItems.Add("MyDotNetControl", _
        "C:\Libraries\ADotNetControl.dll(", _
        vsToolBoxItemFormat.vsToolBoxItemFormatDotNETComponent)
    Catch ex As System.Exception
        ' Display any errors that occur.
        MsgBox("ERROR: " & ex.Message)
    End Try
End Sub

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

ToolBoxItems Interfejs

Przestrzeń nazw EnvDTE

Inne zasoby

Porady: kontrolowanie Przybornika