Estrutura SHDRAGIMAGE (shobjidl_core.h)

  • Artigo

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