IVsHierarchyItemIdentity Interface

 

Contains the information necessary to define an item in an IVsUIHierarchyWindow.

Namespace:   Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.Immutable.11.0 (in Microsoft.VisualStudio.Shell.Immutable.11.0.dll)

[CLSCompliantAttribute(false)]
public interface IVsHierarchyItemIdentity

NameDescription
System_CAPS_pubpropertyHierarchy

Gets the IVsHierarchy representing the outer hierarchy of the item.

System_CAPS_pubpropertyIsNestedItem

Gets whether this item is a nested item or not.

System_CAPS_pubpropertyIsRoot

Gets whether the item is the root of its IVsHierarchy.

System_CAPS_pubpropertyItemID

Gets the item identifier representing the outer item in the hierarchy.

System_CAPS_pubpropertyNestedHierarchy

Gets the nested IVsHierarchy representing the inner hierarchy of the item.

System_CAPS_pubpropertyNestedItemID

Gets the item identifier representing the inner item in the NestedHierarchy.

For items that belong to only a single IVsHierarchy, the IsNestedItem property will be false, and both the Hierarchy / ItemID and NestedHierarchy / NestedItemID pairs will be equal. For a nested item, the Hierarchy / ItemID pair represent the “outer” (nearest-to-the-root) pair, and the NestedHierarchy / NestedItemID pair represent the “nested” (child) pair.

A single item in the Solution Explorer (for example, a C# project node) can actually be composed of two different IVsHierarchy implementations with two different item identifiers. As a specific example, the “solution” is an IVsHierarchy representing the “tree” of items in the solution, but the solution’s IVsHierarchy does not know about the content of projects. A specific C# project in the solution is also a separate IVsHierarchy. The node representing the project itself might be node #50 in the IVsHierarchy for the solution, and node VSITEMID_ROOT in the IVsHierarchy for the project. IVsHierarchyItemIdentity and IVsHierarchyItem bind together these two different IVsHierarchy and item identifiers into a single concept.

Return to top
Show: