Método IVsHierarchyDropDataTarget.DragEnter (IDataObject, UInt32, UInt32, UInt32)

Artigo
04/23/2016

Chamado assim que um item você pode arrastar o mouse sobre uma nova hierarquia ou a janela hierarquia.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int DragEnter(
    IDataObject pDataObject,
    uint grfKeyState,
    uint itemid,
    ref uint pdwEffect
)

int DragEnter(
    IDataObject^ pDataObject,
    unsigned int grfKeyState,
    unsigned int itemid,
    unsigned int% pdwEffect
)

abstract DragEnter : 
        pDataObject:IDataObject *
        grfKeyState:uint32 *
        itemid:uint32 *
        pdwEffect:uint32 byref -> int

Function DragEnter (
    pDataObject As IDataObject,
    grfKeyState As UInteger,
    itemid As UInteger,
    ByRef pdwEffect As UInteger
) As Integer

Parâmetros

pDataObject
[in] Ponteiro para o IDataObject interface no item que está sendo arrastado.Este objeto de dados contém os dados transferidos na operação de arrastar-e-soltar.Se ocorre a soltura, esse objeto de dados (item) é incorporado na janela de hierarquia.

grfKeyState
[in] Estado atual do teclado e as teclas modificadoras de mouse.Os valores válidos são mostrados na tabela a seguir.Esses valores podem ser combinados com um operador bit a bit de ou.

[1|1] Hex

[1|2] Valor

[1|3] Descrição

[2] 0x0001

[2|2] MK_LBUTTON

[2|3] Botão esquerdo do mouse é clicado.

[3|1] 0x0002

[3|2] MK_RBUTTON

[3|3] Botão direito do mouse é clicado.

[4|1] 0x0004

[4|2] MK_SHIFT

[4|3] SHIFT tecla é pressionada.

[5|1] 0x0008

[5|2] MK_CONTROL

[5|3] Controle tecla é pressionada.

0x0010 [6|1]

[6|2] MK_MBUTTON

[6|3] Botão do meio do mouse é clicado.

0x0020 [7|1]

[7|2] MK_ALT

[7|3] ALT tecla é pressionada.

itemid
[in] Identificador de item do item sendo arrastado.Para obter uma lista de itemid valores, consulte VSITEMID.

pdwEffect
[in, out] Na entrada, o ponteiro para o valor da pdwEffect parâmetro da IVsHierarchy objeto, identificando todos os efeitos que ofereça suporte a hierarquia.No retorno, deve conter um dos sinalizadores que indicam o resultado da operação soltar efeito.Para obter mais informações, consulte IVsHierarchyDropDataSource2.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsHierarchyDropDataTarget::DragEnter(
   [in]IDataObject * pDataObject,
   [in]DWORD grfKeyState,
   [in]VSITEMID itemid,
   [in, out]DWORD * pdwEffect
);

O DragEnter método é chamado quando um item entra primeiro a janela hierarquia ou quando o item é arrastado sobre uma nova hierarquia.Depois de chamar o DragEnter método, as chamadas de hierarquia o DragOver até que o item deixa a janela de hierarquia, ou uma nova hierarquia na qual apontá-lo em chamadas de método do DragLeave ou Drop método.

O DragEnter método também passa no estado das teclas do teclado e botões do mouse (se está sendo pressionado a um ou mais).

Soltar efeitos estão incluídos na pdwEffect parâmetro e descreva a ação associada a uma operação de soltar.A tabela a seguir mostra possível pdwEffect valores e suas descrições:

Observação
Esses efeitos são exclusivos e não podem ser combinados com o operador bit a bit de ou.

Nome do efeito	Valor 1	Descrição
DROPEFFECT_NONE	0	O destino de soltar (janela de hierarquia) não pode aceitar os dados.Sem soltar teria permissão.
DROPEFFECT_COPY	1	Item eliminado permanece na fonte e uma cópia dele é adicionada ao destino.
DROPEFFECT_MOVE	2	Eliminados do item foi adicionado ao destino.O item é removido da origem e seu armazenamento é excluído.
DROPEFFECT_LINK	4	Um link para o item de origem é adicionado ao destino.O item de origem, em seguida, deve ser removido da fonte, mas o armazenamento deve permanecer para que o link não é quebrado.Um link é um caso especial de movimentação.

Os valores da pwdEffects parâmetro são obtidas a partir do DragDropEffects enumeração.

Consulte também

Interface IVsHierarchyDropDataTarget
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via