Metoda ToolBoxItems.Add —
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: System.String
Wymagane.Ciąg reprezentujący podpis nowego elementu.
- Data
Typ: System.Object
Wymagane.Wariant, reprezentujących ciąg, formant lub inny element, które mają zostać dodane do Przybornik.
- Format
Typ: EnvDTE.vsToolBoxItemFormat
Opcjonalne.A vsToolBoxItemFormat stałą określającą format nowego elementu.
Wartość zwracana
Typ: EnvDTE.ToolBoxItem
A ToolBoxItem object.
Uwagi
Ta metoda nie powiedzie się, jeśli ToolBoxItems kolekcji należy do ToolBoxTab obiekt, który został usunięty lub jeśli próbować dodać kartę z nazwą już istnieje.
Dla Data argument, Visual C++ użytkowników można przekazać elementu IUnknown z IDataObject.
Po dodaniu zestawu Format typu vsToolBoxItemFormatDotNETComponent, wartość przekazana do Data parametr może być w jednej z następujących formatów:
<AssemblyPath>— W przypadku gdy "<AssemblyPath>" jest ścieżkę i nazwę, wskazując zestawu zarządzanych, takich jak C:\Libraries\MyAssembly.dll.Kiedy używać tego formatu wszystkich klas w ciągu.Biblioteka DLL są dodawane do Przybornik.
<AssemblyNameInTheGAC>— Jedną klasę wymienione jako odwołanie kwalifikowana zestawu.Pojedynczy klas mogą być dodawane jako formanty, pod warunkiem, że są one odwołania do zestawu, 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 jest wymagane Aby dodać użytkownika zestawu w pamięci podręcznej GAC.)
Przykłady
Poniższy przykład ilustruje sposób 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 przedstawia sposób dodawania.NET składnika Przybornik przy użyciu ścieżki do pliku.Musi być składnik ma być dodany.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
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..