IVsHierarchyEvents.OnItemAdded Method

Notifies clients when an item is added to the hierarchy.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
Function OnItemAdded ( _
    itemidParent As UInteger, _
    itemidSiblingPrev As UInteger, _
    itemidAdded As UInteger _
) As Integer
int OnItemAdded(
    uint itemidParent,
    uint itemidSiblingPrev,
    uint itemidAdded
)
int OnItemAdded(
    [InAttribute] unsigned int itemidParent, 
    [InAttribute] unsigned int itemidSiblingPrev, 
    [InAttribute] unsigned int itemidAdded
)
abstract OnItemAdded : 
        itemidParent:uint32 * 
        itemidSiblingPrev:uint32 * 
        itemidAdded:uint32 -> int
function OnItemAdded(
    itemidParent : uint, 
    itemidSiblingPrev : uint, 
    itemidAdded : uint
) : int

Parameters

  • itemidParent
    Type: System.UInt32

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

  • itemidSiblingPrev
    Type: System.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
    Type: System.UInt32

    [in] Identifier of the added item.

Return Value

Type: System.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.

.NET Framework Security

See Also

Reference

IVsHierarchyEvents Interface

Microsoft.VisualStudio.Shell.Interop Namespace