IVsHierarchyEvents.OnItemAdded(UInt32, UInt32, UInt32) Method

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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.