Interface IDropTargetHelper (shobjidl_core.h)

  • Artigo

Expõe métodos que permitem que destinos de soltar exibam uma imagem de arrastar enquanto a imagem está sobre a janela de destino.

Herança

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

Métodos

A interface IDropTargetHelper tem esses métodos.

 
IDropTargetHelper::D ragEnter

Notifica o gerenciador de imagens de arrastar que o método IDropTarget::D ragEnter do destino de soltar foi chamado.
IDropTargetHelper::D ragLeave

Notifica o gerenciador de imagens de arrastar que o método IDropTarget::D ragLeave do destino de soltar foi chamado.
IDropTargetHelper::D ragOver

Notifica o gerenciador de imagens de arrastar que o método IDropTarget::D ragOver do destino de soltar foi chamado.
IDropTargetHelper::D rop

Notifica o gerenciador de imagens de arrastar que o método IDropTarget::D rop do destino de soltar foi chamado.
IDropTargetHelper::Show

Notifica o gerenciador de imagens de arrastar para mostrar ou ocultar a imagem de arrastar.

Comentários

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

Essa interface é usada por destinos de soltar para permitir que o gerenciador de imagens de arrastar exiba a imagem de arrastar enquanto a imagem estiver sobre a janela de destino. As interfaces IDragSourceHelper e IDropTargetHelper são expostas pelo objeto do 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).

Quatro dos métodos IDropTargetHelper correspondem aos quatro métodos IDropTarget . Quando você implementa iDropTarget, cada um de seus métodos deve chamar o método IDropTargetHelper correspondente para passar as informações para o gerenciador de imagens de arrastar. O quinto método IDropTargetHelper notifica o gerenciador de imagens de arrastar para mostrar ou ocultar a imagem de arrastar. Esse método é usado ao arrastar uma janela de destino em um modo de vídeo de baixa profundidade de cor. Ele permite que o destino oculte a imagem de arrastar enquanto está pintando a janela.

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

Requisito Valor
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)

Confira também

IDragSourceHelper

Objeto de dados do Shell