IVsHierarchyEvents.OnItemAdded Method

Article
04/22/2008

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

'Déclaration
Function OnItemAdded ( _
    itemidParent As UInteger, _
    itemidSiblingPrev As UInteger, _
    itemidAdded As UInteger _
) As Integer
'Utilisation
Dim instance As IVsHierarchyEvents
Dim itemidParent As UInteger
Dim itemidSiblingPrev As UInteger
Dim itemidAdded As UInteger
Dim returnValue As Integer

returnValue = instance.OnItemAdded(itemidParent, _
    itemidSiblingPrev, itemidAdded)

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

int OnItemAdded(
    [InAttribute] unsigned int itemidParent, 
    [InAttribute] unsigned int itemidSiblingPrev, 
    [InAttribute] unsigned int itemidAdded
)

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.

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Partager via