UIHierarchyItem Interface

Represents an item that shows hierarchical tree data, such as Solution Explorer, in a standard tool window in the integrated development environment (IDE).

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

Syntax

'Declaration
<GuidAttribute("FBD0D024-09CD-4D9F-9E2B-CACD628426A5")> _
Public Interface UIHierarchyItem
[GuidAttribute("FBD0D024-09CD-4D9F-9E2B-CACD628426A5")]
public interface UIHierarchyItem
[GuidAttribute(L"FBD0D024-09CD-4D9F-9E2B-CACD628426A5")]
public interface class UIHierarchyItem
[<GuidAttribute("FBD0D024-09CD-4D9F-9E2B-CACD628426A5")>]
type UIHierarchyItem =  interface end
public interface UIHierarchyItem

The UIHierarchyItem type exposes the following members.

Properties

  Name Description
Public property Collection Gets the collection containing the UIHierarchyItem object supporting this property.
Public property DTE Gets the top-level extensibility object.
Public property IsSelected Gets whether a node is selected.
Public property Name Gets the name of the object.
Public property Object Gets an object that can be accessed by name at run time.
Public property UIHierarchyItems Gets a collection representing children of the item.

Top

Methods

  Name Description
Public method Select Causes the specified item to become active in the user interface.

Top

Examples

Sub UIHierarchyItemExample()
   'Reference the UIHierarchy, UIHierarchyItem, and OutputWindow objects.
   Dim UIH As UIHierarchy = _
     DTE.Windows.Item(Constants.vsWindowKindMacroExplorer).Object
   Dim samples As UIHierarchyItem = UIH.GetItem("Macros\Samples")
   Dim OWPane As OutputWindowPane = GetOutputWindowPane("List Macros")
   Dim file As UIHierarchyItem

   OWPane.Clear()
   For Each file In samples.UIHierarchyItems
      OWPane.OutputString(file.Name & _
        Microsoft.VisualBasic.Constants.vbCrLf)
      Dim macro As UIHierarchyItem
      For Each macro In file.UIHierarchyItems
         OWPane.OutputString("   " & macro.Name & _
           Microsoft.VisualBasic.Constants.vbCrLf)
      Next
   Next
End Sub

Function GetOutputWindowPane(ByVal Name As String, Optional ByVal show _
  As Boolean = True) As OutputWindowPane
   Dim win As Window = _
     DTE.Windows.Item(EnvDTE.Constants.vsWindowKindOutput)
   If show Then win.Visible = True
   Dim ow As OutputWindow = win.Object
   Dim owpane As OutputWindowPane
   Try
      owpane = ow.OutputWindowPanes.Item(Name)
   Catch e As System.Exception
      owpane = ow.OutputWindowPanes.Add(Name)
   End Try
   owpane.Activate()
   Return owpane
End Function

See Also

Reference

EnvDTE Namespace

Other Resources

How to: Manipulate Tree Views by Using UIHierarchy