Compartilhar via


Método IImageList::BeginDrag (commoncontrols.h)

Começa arrastando uma imagem.

Sintaxe

HRESULT BeginDrag(
  [in] int iTrack,
  [in] int dxHotspot,
  [in] int dyHotspot
);

Parâmetros

[in] iTrack

Tipo: int

Um valor do tipo int que contém o índice da imagem a ser arrastada.

[in] dxHotspot

Tipo: int

Um valor do tipo int que contém o componente x da posição de arrastar em relação ao canto superior esquerdo da imagem.

[in] dyHotspot

Tipo: int

Um valor do tipo int que contém o componente y da posição de arrastar em relação ao canto superior esquerdo da imagem.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

IImageList::BeginDrag cria uma lista de imagens temporária que é usada para arrastar. Em resposta às mensagens WM_MOUSEMOVE subsequentes, você pode mover a imagem de arrastar usando IImageList::D ragMove. Para encerrar a operação de arrastar, você pode usar IImageList::EndDrag.

Para usar IImageList::BeginDrag, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [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 commoncontrols.h
DLL Comctl32.dll (versão 6.0 ou posterior)