ToolBoxItems.Add – metoda

Článek
10/27/2012

Vytvoří novou položku a přidá ji nástrojů.

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žky, které mají být přidány do nástrojů.

Format
Typ: EnvDTE.vsToolBoxItemFormat
Nepovinné.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 chcete-li přidat záložku s názvem, které je 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>" je cesta a název, například přejdete spravované sestavení 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 nástrojů.
<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í, který je v globální mezipaměť sestavení (GAC) (GAC) například: 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í do mezipaměti GAC.)

Příklady

Následující příklad ukazuje, jak přidat text dokumentu 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.NET komponentu nástrojů pomocí cesty k souboru.Musí být součásti, které mají být přidány.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.

Viz také

Referenční dokumentace

ToolBoxItems Rozhraní

EnvDTE – obor názvů

Další zdroje

Postup: ovládání panelu

Sdílet prostřednictvím