DTE2 Interface

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

The top-level object in the Visual Studio automation object model.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

[GuidAttribute("2EE1E9FA-0AFE-4348-A89F-ED9CB45C99CF")]
public interface DTE2 : _DTE

The DTE2 type exposes the following members.

  NameDescription
Public propertyActiveDocumentGets the active document.
Public propertyActiveSolutionProjectsGets an array of currently selected projects.
Public propertyActiveWindowGets the currently active window, or the top-most window if no others are active.
Public propertyAddInsGets the AddIns collection, which contains all currently available Add-ins.
Public propertyApplicationInfrastructure. Microsoft Internal Use Only.
Public propertyCommandBarsGets a reference to the development environment's CommandBars object.
Public propertyCommandLineArgumentsGets a string representing the command line arguments.
Public propertyCommandsGets the Commands collection.
Public propertyContextAttributesGets a ContextAttributes collection which allows automation clients to add new attributes to the current selected items in the Dynamic Help window and provide contextual help for the additional attributes.
Public propertyDebuggerGets the debugger objects.
Public propertyDisplayModeGets or sets the display mode, either MDI or Tabbed Documents.
Public propertyDocumentsGets the collection of open documents in the development environment.
Public propertyDTEGets the top-level extensibility object.
Public propertyEditionGets a description of the edition of the environment.
Public propertyEventsGets a reference to the Events object.
Public propertyFileNameInfrastructure. Microsoft Internal Use Only.
Public propertyFindGets the Find object that represents global text find operations.
Public propertyFullNameGets the full path and name of the object's file.
Public propertyGlobalsGets the Globals object that contains Add-in values that may be saved in the solution (.sln) file, the project file, or in the user's profile data.
Public propertyIsOpenFileInfrastructure. Microsoft Internal Use Only.
Public propertyItemOperationsGets the ItemOperations object.
Public propertyLocaleIDGets the ID of the locale in which the development environment is running.
Public propertyMacrosGets the Macros object.
Public propertyMacrosIDEGets the root of the Macros IDE's automation model.
Public propertyMainWindowGets a Window object representing the main development environment window.
Public propertyModeGets the mode of the development environment, either debug or design.
Public propertyNameGets the name of the DTE.
Public propertyObjectExtendersGets the ObjectExtenders object.
Public propertyPropertiesGets a Properties collection representing all available categories and subcategories contained in the Options dialog box on the Tools menu.
Public propertyRegistryRootGets a string with the path to the root of the Visual Studio registry settings.
Public propertySelectedItemsGets a collection containing the items currently selected in the environment.
Public propertySolutionGets the Solution object that represents all open projects in the current instance of the environment and allows access to the build objects.
Public propertySourceControlGets a SourceControl object that allows you to manipulate the source code control state of the file behind the object.
Public propertyStatusBarGets the StatusBar object, representing the status bar on the main development environment window.
Public propertySuppressUIGets or sets a value indicating whether user interface (UI) should be displayed during the execution of automation code.
Public propertyToolWindowsGets a ToolWindows object used as a shortcut for finding tool windows.
Public propertyUndoContextGets the global UndoContext object.
Public propertyUserControlGets a value indicating whether the environment was started by a user or by automation.
Public propertyVersionGets the host application's version number.
Public propertyWindowConfigurationsGets the WindowConfigurations collection, representing all available window configurations.
Public propertyWindowsGets a Windows collection containing the windows that display in the object.
Top

  NameDescription
Public methodExecuteCommandExecutes the specified command.
Public methodGetObjectGets an interface or object that is late-bound to the DTE object and can be accessed by name at run time.
Public methodGetThemeColorGets a color used to draw the user interface within Visual Studio.
Public methodLaunchWizardRuns a wizard with the supplied parameters.
Public methodOpenFileInfrastructure. Microsoft Internal Use Only.
Public methodQuitCloses the Visual Studio environment.
Public methodSatelliteDllPathReturns the computed path to the satellite DLL when given the installation directory for an Add-in or wizard and the file name of the DLL containing localized resources.
Top

The DTE object is provided to you by the OnConnection method that you implement when you create an Add-in. The DTE object is the Application object in Visual Basic.

To access project-specific properties such as VBProjects or CSharpProjects, use the syntax DTE.GetObject("VBProjects").

For details about referencing the EnvDTE namespace and the DTE object, see Referencing Automation Assemblies and the DTE2 Object.

Sub DTEExample()
  Dim objTextDoc As TextDocument
  Dim objEP As EditPoint
  
  'Create a new text document.
  DTE2.ItemOperations.NewFile("General\Text File")
  'Get a handle to the new document.
  Set objTextDoc = DTE2.ActiveDocument.Object("TextDocument")
  Set objEP = objTextDoc.StartPoint.CreateEditPoint
  'Create an EditPoint and add some text.
  objEP.Insert "A test sentence."
End Sub
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft