IVsUIHierarchyWindow2 Interface

Implemented by the environment to display the hierarchies that VSPackages write.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Syntax

'Declaration
<GuidAttribute("5B8C06A0-4379-4218-A046-B1DC466E5818")> _
<InterfaceTypeAttribute()> _
Public Interface IVsUIHierarchyWindow2 _
    Inherits IVsUIHierarchyWindow
[GuidAttribute("5B8C06A0-4379-4218-A046-B1DC466E5818")]
[InterfaceTypeAttribute()]
public interface IVsUIHierarchyWindow2 : IVsUIHierarchyWindow
[GuidAttribute(L"5B8C06A0-4379-4218-A046-B1DC466E5818")]
[InterfaceTypeAttribute()]
public interface class IVsUIHierarchyWindow2 : IVsUIHierarchyWindow
[<GuidAttribute("5B8C06A0-4379-4218-A046-B1DC466E5818")>]
[<InterfaceTypeAttribute()>]
type IVsUIHierarchyWindow2 =  
    interface 
        interface IVsUIHierarchyWindow 
    end
public interface IVsUIHierarchyWindow2 extends IVsUIHierarchyWindow

The IVsUIHierarchyWindow2 type exposes the following members.

Methods

  Name Description
Public method AddUIHierarchy Adds an additional root UI hierarchy node to the list managed by the UI hierarchy window.
Public method ExpandItem Controls the state or appearance of items in the hierarchy.
Public method FindCommonSelectedHierarchy Finds the lowermost hierarchy that is the nearest ancestor to every selected node.
Public method GetCurrentSelection(IntPtr%, UInt32%, IVsMultiItemSelect%) Gets the alternate itemID of the current selection when an alternate UIHierarchy is used. (Inherited from IVsUIHierarchyWindow.)
Public method GetCurrentSelection(IVsHierarchy%, UInt32%, IVsMultiItemSelect%) Gets the alternate itemID of the current selection when an alternate UIHierarchy is used.
Public method GetItemState Returns the state or appearance of the hierarchy.
Public method Init Initializes a custom use of a UI hierarchy window.
Public method RemoveUIHierarchy Removes a root UI hierarchy node from the UI hierarchy window.
Public method SetCursor Sets a new cursor for the UI hierarchy window.
Public method SetItemAttribute Sets an item attribute in the specified hierarchy.
Public method SetWindowHelpTopic Sets the Help topic for the hierarchy window.

Top

Remarks

This interface is implemented by the environment to display the hierarchies that are written by VSPackages for the existing hierarchy windows (Solutions Explorer, Macro Explorer, and Server Explorer). Using this interface, VSPackages call into the UI Hierarchy window to add, remove, expand, or select hierarchies in the window.

This interface can also be implemented on a custom UIHierarchy window. To instantiate your own UIHierarchy window, call QueryService on the SVsUIShell Service to get a pointer to the IVsUIShell interface. Once you have the pointer to this interface, call CreateToolWindow (CLSID_VSUIHierarchyWindow). You can use the returned ppWindowFrame to get the ppunkDocView, on which IUnknown::QueryInterface can be called for a pointer to the IVsUIHierarchyWindow interface.

Tool tips in a UIHierarchy window are reserved to show the full caption of the node if the caption is being clipped by the current view (i.e. the window is too narrow to show the full caption). You can not provide custom tool tips for UIHierarchy windows.

See illustrations of the implementation and/or calling of this interface in the sample Basic Project.

Notes for Implementers

Implemented by the environment on the existing hierarchy windows (Solution Explorer, Macro Explorer, and Server Explorer).

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace