Edit

IDragSourceHelper::InitializeFromBitmap method (shobjidl_core.h)

  • Article

Initializes the drag-image manager for a windowless control.

Syntax

HRESULT InitializeFromBitmap(
  [in] LPSHDRAGIMAGE pshdi,
  [in] IDataObject   *pDataObject
);

Parameters

[in] pshdi

Type: LPSHDRAGIMAGE

The SHDRAGIMAGE structure that contains information about the bitmap.

[in] pDataObject

Type: IDataObject*

A pointer to the data object's IDataObject interface.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Because InitializeFromBitmap always performs the RGB multiplication step in calculating the alpha value, you should always pass a bitmap without premultiplied alpha blending. Note that no error will result from passing the method a bitmap with premultiplied alpha blending, but this method will multiply it again, doubling the resulting alpha value.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 5.0 or later)

See also

IDragSourceHelper