IVsHierarchyDropDataSource.OnDropNotify Method

Artikel
12/17/2007

Notifies clients that the dragged item was dropped.

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

Syntax

'Declaration
Function OnDropNotify ( _
    fDropped As Integer, _
    dwEffects As UInteger _
) As Integer
'Usage
Dim instance As IVsHierarchyDropDataSource
Dim fDropped As Integer
Dim dwEffects As UInteger
Dim returnValue As Integer

returnValue = instance.OnDropNotify(fDropped, _
    dwEffects)

int OnDropNotify(
    int fDropped,
    uint dwEffects
)

int OnDropNotify(
    [InAttribute] int fDropped, 
    [InAttribute] unsigned int dwEffects
)

function OnDropNotify(
    fDropped : int, 
    dwEffects : uint
) : int

Parameters

fDropped
Type: System.Int32

[in] If true, then the dragged item was dropped on the target. If false, then the drop did not occur.

dwEffects
Type: System.UInt32

[in] Visual effects associated with the drag-and-drop operation, such as cursors, bitmaps, and so on. The value of dwEffects passed to the source object via OnDropNotify method is the value of pdwEffects returned by Drop method.

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 IVsHierarchyDropDataSource::OnDropNotify(
   [in]BOOL fDropped,
   [in]DWORD dwEffects
);

Use this method to determine whether the data from the source hierarchy was dropped onto the target. , Use the OnBeforeDropNotify method to let the source hierarchy allow or disallow the drop before it occurs.

The dwEffects parameter provides information that is returned by the Drop method, and which specifies the type of drop that occurred. This information is used by the source to determine whether an unanticipated effect occurred during the drop. For example, the user might have dragged an item from the source hierarchy to the target anticipating that the item would be moved to the target. However, if the target doesn't support a move, but does support a link, then the target notifies the source that a link occurred instead of a move. The source then uses this information to know that it should retain, rather than delete, its copy of the item.

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.

Freigeben über