ToolBoxItems.Add Yöntem
Yeni bir öğe 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: System.String
Gerekli.Yeni öğe başlığını gösteren bir dizedir.
- Data
Tür: System.Object
Gerekli.Dize, Denetim veya eklenecek başka bir öğe gösteren bir değişken araç.
- Format
Tür: EnvDTE.vsToolBoxItemFormat
İsteğe Bağlı.A vsToolBoxItemFormat sabit gösteren biçimi, yeni bir madde.
Dönüş Değeri
Tür: EnvDTE.ToolBoxItem
ToolBoxItem nesnesi
Açıklamalar
Bu yöntem, başarısız olur ToolBoxItems toplama ait bir ToolBoxTab silindi veya sekme adı zaten ekleme girişimi var nesneyi.
İçin Data bağımsız değişkeni Visual C++ kullanıcılar IDataObject'i IUnknown geçebilen
Ne zaman, bir derleme, ekleme Format türü vsToolBoxItemFormatDotNETComponent, geçirilen değer Data parametresi aşağıdaki biçimlerden birinde olabilir:
<AssemblyPath>— Burada "<AssemblyPath>" yönetilen bir derleme için gibi gösteren bir yol ve dosya adı olan C:\Libraries\MyAssembly.dll. Bu biçim, tüm sınıfları kullandığınızda.dll eklenen araç.
<AssemblyNameInTheGAC>— Derleme nitelikli bir başvuru olarak listelenen tek bir sınıf. Genel derleme önbelleğine (gac) olan derleme başvurular olmaları koşuluyla tek sınıfları gibi denetimleri olarak eklenebilir: WindowControlLibrary1.UserControl1, WindowControlLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<Your Token>. (Değiştirmek <Your Token> , ortak anahtar belirteci ile gerekli derlemenize gac. eklemek için)
Örnekler
Aşağıdaki örnek, bir metin belgesi 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, nasıl ekleneceğini gösterir bir.Ağ bileşeni araç dosyası için bir yol kullanarak. Eklenecek bileşeni olmalıdır bir.Denetimi gibi net bir Visual Basic Windows Control Library 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üvenilir kod tarafından Kitaplıklar kullanma.