ToolBoxItems.Add – metoda
Vytvoří novou položku a přidá jej do prvky.
Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)
Syntaxe
'Deklarace
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: StringPovinné.Řetězec představující Titulek nové položky.
Data
Typ: ObjectPovinné.Varianta představující řetězec, ovládací prvek nebo jiné položky, které mají být přidány do prvky.
Format
Typ: EnvDTE.vsToolBoxItemFormatVolitelné.A vsToolBoxItemFormat Konstanta určující formát nové položky.
Vrácená hodnota
Typ: EnvDTE.ToolBoxItem
Objekt ToolBoxItem.
Poznámky
Tato metoda se nezdaří, pokud ToolBoxItems kolekce patří ToolBoxTab objekt, který byl odstraněn nebo pokud se pokusíte přidat kartu s názvem, které již existuje.
Pro Data argument, Visual C++ by uživatelé mohli převést IUnknown objekt IDataObject.
Po přidání sestavení z Format typu vsToolBoxItemFormatDotNETComponent, hodnota předaná Data parametr může být v některém z následujících formátů:
<AssemblyPath>– "< AssemblyPath >" je cesta a název spravované sestavení, jako například přejdete-li C:\Libraries\MyAssembly.dll.Při použití tohoto formátu v rámci všech tříd.Knihovny DLL je přidán do prvky.
<AssemblyNameInTheGAC>– Jediné třídy uveden jako odkaz na sestavení kvalifikované.Jediné třídy lze přidat jako ovládací prvky, pokud jsou odkazy na sestavení v globální mezipaměť sestavení (GAC) (GAC), jako: WindowControlLibrary1.UserControl1, WindowControlLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<Your Token>. (Měli byste nahradit <Your Token> s vaší token veřejného klíče, který je požadován přidat vaše sestavení v GAC.)
Příklady
Následující příklad ukazuje, jak přidat textový dokument nástrojů:
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
Následující příklad ukazuje, jak přidat součásti .NET nástrojů pomocí cesty k souboru.Ovládací prvek .NET musí být jako součásti, které mají být přidány Visual Basic komponenty knihovny ovládacích prvků 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
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.