IVsHierarchyItem Interface

Contains instance property information for a single item in an IVsUIHierarchyWindow.

This API is not CLS-compliant. 

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

Syntax

'Declaration
<CLSCompliantAttribute(False)> _
Public Interface IVsHierarchyItem _
    Inherits ISupportDisposalNotification, INotifyPropertyChanged, INotifyPropertyChanging
[CLSCompliantAttribute(false)]
public interface IVsHierarchyItem : ISupportDisposalNotification, 
    INotifyPropertyChanged, INotifyPropertyChanging
[CLSCompliantAttribute(false)]
public interface class IVsHierarchyItem : ISupportDisposalNotification, 
    INotifyPropertyChanged, INotifyPropertyChanging
[<CLSCompliantAttribute(false)>]
type IVsHierarchyItem =  
    interface 
        interface ISupportDisposalNotification 
        interface INotifyPropertyChanged 
        interface INotifyPropertyChanging 
    end
public interface IVsHierarchyItem extends ISupportDisposalNotification, INotifyPropertyChanged, INotifyPropertyChanging

The IVsHierarchyItem type exposes the following members.

Properties

  Name Description
Public property AreChildrenRealized Indicates whether the child items of an IVsHierarchyItem have already been enumerated.
Public property CanonicalName Gets the canonical name of the item, corresponding to the GetCanonicalName.
Public property Children Gets the child items of this IVsHierarchyItem.
Public property HierarchyIdentity Gets the identity that represents this item.
Public property IsBold Gets or sets whether this item should be rendered bold in an IVsUIHierarchyWindow.
Public property IsCut Gets or sets whether this item should be rendered as a cut item in an IVsUIHierarchyWindow.
Public property IsDisposed Determines if the item is disposed. (Inherited from ISupportDisposalNotification.)
Public property Parent Gets the parent IVsHierarchyItem for this item.
Public property Text Gets the text caption for the item in the IVsUIHierarchyWindow, corresponding to the VSHPROPID_Caption property from GetProperty.

Top

Events

  Name Description
Public event PropertyChanged Occurs when a property value changes. (Inherited from INotifyPropertyChanged.)
Public event PropertyChanging Occurs when a property value is changing. (Inherited from INotifyPropertyChanging.)

Top

Remarks

An IVsHierarchyItem has an associated IVsHierarchyItemIdentity that defines the IVsHierarchy/item identifier or IVsHierarchy/item identifier pair that represents the item. This interface also lets you get properties like text for the items and to enumerate its child and parent items.

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.

See Also

Reference

Microsoft.VisualStudio.Shell Namespace