IVsUIHierarchyWindow2 Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Implemented by the environment to display the hierarchies that VSPackages write.
public interface class IVsUIHierarchyWindow2 : Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchyWindow
public interface class IVsUIHierarchyWindow2 : Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchyWindow
__interface IVsUIHierarchyWindow2 : Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchyWindow
[System.Runtime.InteropServices.Guid("5B8C06A0-4379-4218-A046-B1DC466E5818")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsUIHierarchyWindow2 : Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchyWindow
[<System.Runtime.InteropServices.Guid("5B8C06A0-4379-4218-A046-B1DC466E5818")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsUIHierarchyWindow2 = interface
interface IVsUIHierarchyWindow
Public Interface IVsUIHierarchyWindow2
Implements IVsUIHierarchyWindow
- Attributes
- Implements
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).
Methods
AddUIHierarchy(IVsUIHierarchy, UInt32) |
Adds an additional root UI hierarchy node to the list managed by the UI hierarchy window. |
ExpandItem(IVsUIHierarchy, UInt32, EXPANDFLAGS) |
Controls the state or appearance of items in the hierarchy. |
FindCommonSelectedHierarchy(UInt32, IVsUIHierarchy) |
Finds the lowermost hierarchy that is the nearest ancestor to every selected node. |
GetCurrentSelection(IntPtr, UInt32, IVsMultiItemSelect) |
Gets the alternate itemID of the current selection when an alternate UIHierarchy is used. (Inherited from IVsUIHierarchyWindow) |
GetCurrentSelection(IVsHierarchy, UInt32, IVsMultiItemSelect) |
Gets the alternate itemID of the current selection when an alternate UIHierarchy is used. |
GetItemState(IVsUIHierarchy, UInt32, UInt32, UInt32) |
Returns the state or appearance of the hierarchy. |
Init(IVsUIHierarchy, UInt32, Object) |
Initializes a custom use of a UI hierarchy window. |
RemoveUIHierarchy(IVsUIHierarchy) |
Removes a root UI hierarchy node from the UI hierarchy window. |
SetCursor(IntPtr, IntPtr) |
Sets a new cursor for the UI hierarchy window. |
SetItemAttribute(IVsUIHierarchy, UInt32, UInt32, Object) |
Sets an item attribute in the specified hierarchy. |
SetWindowHelpTopic(String, UInt32) |
Sets the Help topic for the hierarchy window. |