Estrutura SHDRAGIMAGE (shobjidl_core.h)

Contém as informações necessárias para criar uma imagem de arrastar.

Sintaxe

typedef struct SHDRAGIMAGE {
  SIZE     sizeDragImage;
  POINT    ptOffset;
  HBITMAP  hbmpDragImage;
  COLORREF crColorKey;
} SHDRAGIMAGE, *LPSHDRAGIMAGE;

Membros

sizeDragImage

Tipo: SIZE

Uma estrutura SIZE com o comprimento e a largura da imagem de arrastar.

ptOffset

Tipo: POINT

Uma estrutura POINT que especifica o local do cursor dentro da imagem de arrastar. A estrutura deve conter o deslocamento do canto superior esquerdo da imagem de arrastar para o local do cursor.

hbmpDragImage

Tipo: HBITMAP

A alça de bitmap da imagem de arrastar.

crColorKey

Tipo: COLORREF

A cor usada pelo controle para preencher a tela de fundo da imagem de arrastar.

Comentários

No Windows Vista, essa estrutura é definida em Shobjidl.idl. Antes disso, ele foi definido em Shlobj.h.

Use o procedimento a seguir para criar a imagem de arrastar.

1. Crie um bitmap do tamanho especificado por sizeDragImage com um identificador para um contexto de dispositivo (HDC) compatível com a tela.
2. Desenhe o bitmap.
3. Selecione o bitmap do HDC com o qual ele foi criado.
4. Destrua o HDC.
5. Atribua a alça de bitmap a hbmpDragImage.

Nota Desative a suavização ao desenhar texto. Caso contrário, os artefatos podem ocorrer nas bordas, entre a cor do texto e a chave de cor.

 

Requisitos

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

Confira também

IDragSourceHelper::InitializeFromBitmap

IDragSourceHelper::InitializeFromWindow