IVsHierarchyEvents.OnItemAdded(UInt32, UInt32, UInt32) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

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.

Notifies clients when an item is added to the hierarchy.

public:
 int OnItemAdded(System::UInt32 itemidParent, System::UInt32 itemidSiblingPrev, System::UInt32 itemidAdded);

public:
 int OnItemAdded(unsigned int itemidParent, unsigned int itemidSiblingPrev, unsigned int itemidAdded);

int OnItemAdded(unsigned int itemidParent, unsigned int itemidSiblingPrev, unsigned int itemidAdded);

public int OnItemAdded (uint itemidParent, uint itemidSiblingPrev, uint itemidAdded);

abstract member OnItemAdded : uint32 * uint32 * uint32 -> int

Public Function OnItemAdded (itemidParent As UInteger, itemidSiblingPrev As UInteger, itemidAdded As UInteger) As Integer

Parameters

itemidParent: UInt32

[in] Identifier of the parent, or root node of the hierarchy in which the item is added.

itemidSiblingPrev: UInt32

[in] Identifier that indicates where the item is added in relation to other items (siblings) within the parent hierarchy (itemidParent). If the new item is added at the beginning of the sibling items, then a value of VSITEMID_NIL is specified. If the item is added after a particular node, the Item Id of the node in question is specified.

itemidAdded: UInt32

[in] Identifier of the added item.

Returns

Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

HRESULT IVsHierarchyEvents::OnItemAdded(  
   [in] VSITEMID itemidParent,  
   [in] VSITEMID itemidSiblingPrev,  
   [in] VSITEMID itemidAdded  
);

The itemidSiblingPrev parameter controls the order in which the added item appears. For example, if you are adding item C, you would need to pass in the itemidSiblingPrev for an existing item B, for C to appear after B.

Applies to