IVsHierarchyItemIdentity Interface

Definition

Namespace:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.Framework.dll

Package:

Microsoft.VisualStudio.Shell.Framework v17.11.40262

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

public interface IVsHierarchyItemIdentity

type IVsHierarchyItemIdentity = interface

Public Interface IVsHierarchyItemIdentity

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.