Interfaz IDragSourceHelper (shobjidl_core.h)

  • Artículo

Expuesto por el Shell para permitir que una aplicación especifique la imagen que se mostrará durante una operación de arrastrar y colocar shell.

Herencia

La interfaz IDragSourceHelper hereda de la interfaz IUnknown . IDragSourceHelper también tiene estos tipos de miembros:

Métodos

La interfaz IDragSourceHelper tiene estos métodos.

 
IDragSourceHelper::InitializeFromBitmap

Inicializa el administrador de imágenes de arrastre para un control sin ventanas.
IDragSourceHelper::InitializeFromWindow

Inicializa el administrador de imágenes de arrastre para un control con una ventana.

Comentarios

Este administrador de imágenes de arrastre expone esta interfaz. Las aplicaciones no lo implementan.

Use esta interfaz para especificar la imagen que se muestra durante una operación de arrastrar y colocar shell. Las interfaces IDragSourceHelper, IDropTargetHelper e IInitializeWithWindow se exponen mediante el objeto de administrador de imágenes de arrastre para permitir que la interfaz IDropTarget use imágenes de arrastrar personalizadas. Para usar cualquiera de estas interfaces, debe crear un objeto drag-image manager de servidor en proceso mediante una llamada a CoCreateInstance con un identificador de clase (CLSID) de CLSID_DragDropHelper. Obtiene punteros de interfaz mediante procedimientos estándar del Modelo de objetos componentes (COM).

La interfaz IDragSourceHelper proporciona las dos maneras siguientes de especificar el mapa de bits que se usará como una imagen de arrastre.

  • Los controles que tienen una ventana pueden registrar un mensaje de ventana de DI_GETDRAGIMAGE para él e inicializar el administrador de imágenes de arrastre con IDragSourceHelper::InitializeFromWindow. Cuando se recibe el mensaje DI_GETDRAGIMAGE, el controlador coloca la información del mapa de bits de la imagen de arrastre en la estructura SHDRAGIMAGE que se pasa como el valor lParam del mensaje.
  • Los controles sin ventanas pueden inicializar el administrador de imágenes de arrastre con IDragSourceHelper::InitializeFromBitmap. Este método permite a una aplicación especificar simplemente el mapa de bits.
Nota El objeto auxiliar de arrastrar y colocar llama a IDataObject::SetData para cargar formatos privados (que se usan para la compatibilidad entre procesos) en el objeto de datos. Más adelante recupera estos formatos llamando a IDataObject::GetData. Para admitir el objeto auxiliar de arrastrar y colocar, las implementaciones SetData y GetData del objeto de datos deben ser capaces de aceptar y devolver formatos privados arbitrarios.
 
Para obtener más información sobre las operaciones de arrastrar y colocar shell, consulte Transferencia de datos de Shell mediante arrastrar y colocar o el Portapapeles.
Nota Antes de Windows Vista, esta interfaz se declaró en Shlobj.h.
 

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)