IVsHierarchyItemIdentity Interface

Definition

Important

This API is not CLS-compliant.

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

public interface class IVsHierarchyItemIdentity
public interface class IVsHierarchyItemIdentity
__interface IVsHierarchyItemIdentity
[System.CLSCompliant(false)]
public interface IVsHierarchyItemIdentity
public interface IVsHierarchyItemIdentity
[<System.CLSCompliant(false)>]
type IVsHierarchyItemIdentity = interface
type IVsHierarchyItemIdentity = interface
Public Interface IVsHierarchyItemIdentity
Attributes

Remarks

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.

Properties

Hierarchy

Gets the IVsHierarchy representing the outer hierarchy of the item.

IsNestedItem

Gets whether this item is a nested item or not.

IsRoot

Gets whether the item is the root of its IVsHierarchy.

ItemID

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

NestedHierarchy

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

NestedItemID

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

Applies to