ToolBoxItem2.DTE Property
Gets the top-level extensibility object.
Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)
Syntax
'Declaration
ReadOnly Property DTE As DTE
DTE DTE { get; }
property DTE^ DTE {
DTE^ get ();
}
abstract DTE : DTE with get
function get DTE () : DTE
Property Value
Type: EnvDTE.DTE
A DTE object.
Remarks
In Visual Studio, the DTE object is the root of the automation model, which other object models often call "Application".
Examples
This example selects the second ToolBoxItem2 item and displays its name in a message box. The example also displays the caption for the active window, obtained through the ToolBoxItem2.DTE object. For more information about how to run this example as an add-in, see How to: Compile and Run the Automation Object Model Code Examples.
Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
_applicationObject = CType(application, DTE2)
_addInInstance = CType(addInInst, AddIn)
ToolBoxItemDTEExample(_applicationObject)
End Sub
Sub ToolBoxItemDTEExample(ByVal dte As DTE2)
Dim tlBox As ToolBox
Dim tbxTabs As ToolBoxTabs
Dim tbxTab As ToolBoxTab2
Dim tbxItem As ToolBoxItem2
' Before running this example, open a Windows Application project.
Try
' Create an object reference to the IDE's ToolBox object and
' its tabs.
tlBox = CType(_applicationObject.Windows.Item _
(Constants.vsWindowKindToolbox).Object, ToolBox)
tbxTabs = tlBox.ToolBoxTabs
' Select the second Toolbox tab.
tbxTab = CType(tbxTabs.Item(2), ToolBoxTab2)
tbxTab.Activate()
MsgBox("Toolbox tab name: " & tbxTab.Name)
tbxItem = CType(tbxTab.ToolBoxItems.Item(2), ToolBoxItem2)
MsgBox("Toolbox item name: " & tbxItem.Name)
MsgBox(tbxItem.Name & "'s active window caption, _
obtained through the DTE object:" & vbCr _
& tbxItem.DTE.ActiveWindow.Caption)
Catch ex As System.Exception
MsgBox("ERROR: " & ex.Message)
End Try
End Sub
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application,
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
_applicationObject = (DTE2)application;
_addInInstance = (AddIn)addInInst;
ToolBoxItemDTEExample(_applicationObject);
}
public void ToolBoxItemDTExample(DTE2 dte)
{
ToolBox tlBox;
ToolBoxTabs tbxTabs;
ToolBoxTab2 tbxTab;
ToolBoxItem2 tbxItem;
// Before running this example, open a Windows Application project
// and select Toolbox from the View menu.
try
{
// Create an object reference to the IDE's ToolBox object
// and its tabs.
tlBox = (ToolBox)_applicationObject.Windows.Item
(Constants.vsWindowKindToolbox).Object;
tbxTabs = tlBox.ToolBoxTabs;
// Select the second Toolbox tab.
tbxTab = (ToolBoxTab2)tbxTabs.Item(2);
tbxTab.Activate();
MessageBox.Show("Toolbox tab name: " + tbxTab.Name);
tbxItem = (ToolBoxItem2)tbxTab.ToolBoxItems.Item(2);
MessageBox.Show("Toolbox item name: " + tbxItem.Name);
MessageBox.Show(tbxItem.Name + "'s active window caption,
obtained through the DTE object:" + "\n"
+ tbxItem.DTE.ActiveWindow.Caption);
}
catch (Exception ex)
{
MessageBox.Show("ERROR: " + ex.Message);
}
}
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.