ToolBoxItems.Add Yöntem
Yeni bir madde oluşturur ve ekler araç.
Ad alanı: EnvDTE
Derleme: EnvDTE (EnvDTE.dll içinde)
Sözdizimi
'Bildirim
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
Parametreler
Name
Tür: StringGerekli.Yeni öğe başlığını gösteren bir dizedir.
Data
Tür: ObjectGerekli.Dize, denetimi veya başka bir öğe için eklenecek temsil eden bir değişken araç.
Format
Tür: EnvDTE.vsToolBoxItemFormatİsteğe bağlı.A vsToolBoxItemFormat yeni öğe biçimi belirten sabit.
Dönüş Değeri
Tür: EnvDTE.ToolBoxItem
ToolBoxItem nesnesi
Notlar
Bu yöntem başarısız olur ToolBoxItems koleksiyonuna ait bir ToolBoxTab silinmiş olabilir veya sekme bir adla önceden eklemeyi denediğinizde var. nesne.
İçin Data bağımsız değişkeni, Visual C++ kullanıcıların bilgisine, IUnknown iletebilir.
Ne zaman, bir derlemenin ekleme Format türü vsToolBoxItemFormatDotNETComponent, geçirilen değerini Data parametresi aşağıdaki biçimlerden birini olabilir:
<AssemblyPath>— "< AssemblyPath >" yönetilen bir derleme gibi işaret eden bir yol ve dosya adı burada C:\Libraries\MyAssembly.dll.Bu biçim, içinde tüm sınıfları kullandığınızda.DLL eklenir araç.
<AssemblyNameInTheGAC>— Derleme nitelikli başvuru olarak listelenen tek bir sınıfı.Tek sınıfları eklenebilir denetimleri, Genel Derleme Önbelleği (GAC) derleme başvurular olmaları kaydıyla gibi: WindowControlLibrary1.UserControl1, WindowControlLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<Your Token>. (İçeriðiyle deðiþtirir <Your Token> , ortak anahtar belirteci ile hangi için gerekli olduğunu derlemenizi GAC'ye ekleyin.)
Örnekler
Aşağıdaki örnek bir metin belgesine eklemek gösterilmiştir araç:
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
Aşağıdaki örnek bir .NET bileþeni ekleme gösterilmiştir araç dosyası için bir yol kullanarak.Eklenecek bileşeni bir .NET denetimi aşağıdaki gibi olmalıdır bir Visual Basic Windows Denetim Kitaplığı bileşeni.
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
.NET Framework Güvenliği
- Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen Güvenilen Koddan Kitaplıkları Kullanma.