Condividi tramite


Metodo ToolBoxItems.Add

crea un nuovo elemento e lo aggiunge al Casella degli strumenti.

Spazio dei nomi:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

  • Name
    Tipo: System.String
    obbligatorio.Stringa che rappresenta la barra del titolo del nuovo elemento.
  • Data
    Tipo: System.Object
    obbligatorio.Una variante che rappresenta la stringa, controllo, o un altro elemento al progetto Casella degli strumenti.

Valore restituito

Tipo: EnvDTE.ToolBoxItem
In ToolBoxItem oggetto.

Note

Questo metodo ha esito negativo se ToolBoxItems la raccolta appartiene a un oggetto ToolBoxTab oggetto che è stato eliminato, o se si tenta di aggiungere una scheda con un nome già esistente.

per Data argomento, Visual C++ gli utenti possono passare di IUnknown di IDataObject.

Quando si aggiunge un assembly di Format tipo vsToolBoxItemFormatDotNETComponent, il valore passato a Data il parametro può essere nell'uno dei formati seguenti:

  • <AssemblyPath>- Dove “ <AssemblyPath> “è un percorso e un nome file che punta a un assembly gestito, ad esempio C:\Libraries\MyAssembly.dll.Quando si utilizza questo formato, tutte le classi all'interno di è tuttavia consigliabile vengono aggiunti a Casella degli strumenti.

  • <AssemblyNameInTheGAC>- Una singola classe elencata come riferimento completo dell'assembly.Le singole classi possono essere aggiunte come controlli, se sono riferimenti a un assembly che si trova nella Global Assembly Cache (GAC), ad esempio: WindowControlLibrary1.UserControl1, WindowControlLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<Your Token>.(Sostituito <Your Token> con il token di chiave pubblica, che è necessario aggiungere l'assembly alla GAC.)

Esempi

Nell'esempio seguente viene illustrato come aggiungere un documento di testo a Casella degli strumenti:

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

Nell'esempio seguente viene illustrato come aggiungere un componente.NET a Casella degli strumenti utilizzando un percorso del file.Il componente da parte deve essere un controllo.NET, ad esempio Visual Basic Componente di libreria di controlli 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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ToolBoxItems Interfaccia

Spazio dei nomi EnvDTE

Altre risorse

Procedura: controllare la Casella degli strumenti