Interface IDragSourceHelper (shobjidl_core.h)

  • Artigo

Exposto pelo Shell para permitir que um aplicativo especifique a imagem que será exibida durante uma operação de arrastar e soltar do Shell.

Herança

A interface IDragSourceHelper herda da interface IUnknown . IDragSourceHelper também tem estes tipos de membros:

Métodos

A interface IDragSourceHelper tem esses métodos.

 
IDragSourceHelper::InitializeFromBitmap

Inicializa o gerenciador de imagens de arrastar para um controle sem janelas.
IDragSourceHelper::InitializeFromWindow

Inicializa o gerenciador de imagens de arrastar para um controle com uma janela.

Comentários

Essa interface é exposta pelo gerenciador de imagens de arrastar do Shell. Ele não é implementado por aplicativos.

Use essa interface para especificar a imagem exibida durante uma operação de arrastar e soltar do Shell. As interfaces IDragSourceHelper, IDropTargetHelper e IInitializeWithWindow são expostas pelo objeto gerenciador de imagens de arrastar para permitir que a interface IDropTarget use imagens de arrastar personalizadas. Para usar qualquer uma dessas interfaces, você deve criar um objeto gerenciador de imagens de arrastar servidor em processo chamando CoCreateInstance com um CLSID (identificador de classe) de CLSID_DragDropHelper. Obtenha ponteiros de interface usando procedimentos PADRÃO (COMPONENT Object Model).

A interface IDragSourceHelper fornece as duas maneiras a seguir de especificar o bitmap a ser usado como uma imagem de arrastar.

  • Os controles que têm uma janela podem registrar uma mensagem de janela DI_GETDRAGIMAGE para ela e inicializar o gerenciador de imagens de arrastar com IDragSourceHelper::InitializeFromWindow. Quando a mensagem DI_GETDRAGIMAGE é recebida, o manipulador coloca as informações de bitmap da imagem de arrastar na estrutura SHDRAGIMAGE que é passada como o valor lParam da mensagem.
  • Os controles sem janelas podem inicializar o gerenciador de imagens de arrastar com IDragSourceHelper::InitializeFromBitmap. Esse método permite que um aplicativo simplesmente especifique o bitmap.
Nota O objeto auxiliar de arrastar e soltar chama IDataObject::SetData para carregar formatos privados — usados para suporte entre processos — no objeto de dados. Posteriormente, ele recupera esses formatos chamando IDataObject::GetData. Para dar suporte ao objeto auxiliar de arrastar e soltar, as implementações SetData e GetData do objeto de dados devem ser capazes de aceitar e retornar formatos privados arbitrários.
 
Para obter mais discussões sobre operações de arrastar e soltar do Shell, consulte Transferindo dados do Shell usando arrastar e soltar ou a área de transferência.
Nota Antes do Windows Vista, essa interface era declarada em Shlobj.h.
 

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)