ToolBoxItems.Add – metoda
Vytvoří novou položku a přidá ji panel.
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: System.String
Povinné.Řetězec představující Titulek nové položky.
- Data
Typ: System.Object
Povinné.Varianta představuje řetězec, řízení nebo jiná položka přidána do panel.
- Format
Typ: EnvDTE.vsToolBoxItemFormat
Nepovinné.A vsToolBoxItemFormat Konstanta určující formát nové položky.
Vrácená hodnota
Typ: EnvDTE.ToolBoxItem
A ToolBoxItem objektu.
Poznámky
Tato metoda selže, pokud ToolBoxItems kolekce patří ToolBoxTab objekt, který byl odstraněn nebo pokud se pokusíte přidat záložku s názvem to již existuje.
Pro Data argument, Visual C++ uživatelům předat IUnknown IDataObject.
Při přidání sestavení z Format typu vsToolBoxItemFormatDotNETComponent, hodnota předaná Data parametr může být v jednom z následujících formátů:
<AssemblyPath>– Kde "<AssemblyPath>" Cesta a název přejdete spravované sestavení, jako je C:\Libraries\MyAssembly.dll. Při použití tohoto formátu v rámci všech tříd.Knihovna DLL jsou přidány do panel.
<AssemblyNameInTheGAC>– Jediné třídy uveden jako referenční kvalifikované sestavení. 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>. (By nahradit <Your Token> s vaší token veřejného klíče, která je požadována přidat vaše sestavení GAC.)
Příklady
Následující příklad ukazuje, jak přidat text dokumentu panel:
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.NET součásti panel pomocí cesty k souboru. Musí být součást přidávané.NET ovládacího prvku, například Visual Basic součástí řídicí knihovna systému 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.