IVsHierarchyDropDataTarget.DragEnter – metoda (IDataObject, UInt32, UInt32, UInt32)

Článek
10/12/2015

Nazývá se co nejdříve položky myší přes okno hierarchie nebo novou hierarchii.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

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

Parametry

pDataObject
[v] Ukazatel IDataObject na položku taženého rozhraní.Tento objekt dat obsahuje data a přetažení operace přenosu.Pokud dojde k poklesu, tento objekt dat (zboží) je začleněna do okna hierarchie.

grfKeyState
[v] Aktuální stav klávesnice a myši modifikační klávesy.Platné hodnoty jsou uvedeny v následující tabulce.Tyto hodnoty mohou být kombinovány bitového operátoru OR.

[1|1] Hex

[1|2] Hodnota

[1|3] Popis

[2|1] 0x0001

[2|2] MK_LBUTTON

[2|3] Klepnutí levým tlačítkem myši.

[3|1] 0x0002

[3|2] MK_RBUTTON

[3|3] Klepnutí pravým tlačítkem myši.

[4|1] 0x0004

[4|2] MK_SHIFT

[4|3] SHIFT stisknutí klávesy.

[5|1] 0x0008

[5|2] MK_CONTROL

[5|3] Řízení stisknutí klávesy.

[6|1] 0x0010

[6|2] MK_MBUTTON

[6|3] Klepnutí na střední tlačítko myši.

[7|1] 0x0020

[7|2] MK_ALT

[7|3] ALT stisknutí klávesy.

itemid
[v] Identifikátor zboží položky aktuálně přetáhli.Seznam itemid hodnoty, viz VSITEMID.

pdwEffect
[v, out] V položce ukazatel na hodnotu pdwEffect parametr IVsHierarchy objekt a identifikuje všechny efekty, které podporuje hierarchie.Při návratu musí obsahovat jeden efekt příznaků, které označují výsledek operace přetažení.Další informace naleznete v tématu IVsHierarchyDropDataSource2.

Vrácená hodnota

Type: System.Int32

Pokud metoda uspěje, vrací S_OK.Pokud se nezdaří, vrátí kód chyby.

Poznámky

Podpis COM

Z vsshell.idl:

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

DragEnter Je volána metoda položku nejprve zadá okno hierarchie nebo při přetažení položky přes novou hierarchii.Po volání DragEnter metoda, hierarchie volání DragOver metoda dokud zboží opustí novou hierarchii nebo okno hierarchie, na kdy je volání DragLeave nebo Drop metoda.

DragEnter Metoda předá také ve stavu klávesy a tlačítka myši (zda je stisknutí jednoho nebo více).

Součástí jsou efekty Vržený pdwEffect parametr a popisují akce přidružená k operaci přetažení.Následující tabulka ukazuje možné pdwEffect hodnoty a jejich popis:

[!POZNÁMKA]

Tyto efekty jsou výhradní a nelze kombinovat bitového operátoru.

Název EFEKTU	Hodnota 1	Description
DROPEFFECT_NONE	0	Cíl přetažení (okno hierarchie) nelze přijmout data.Žádné přímé by povoleny.
DROPEFFECT_COPY	1	Zamítnuté položky zůstanou ve zdroji a jeho kopii je přidán k cíli.
DROPEFFECT_MOVE	2	Cíl byl přidán zamítnuté položky.Je položka odstraněna ze zdroje a je odstraněn jeho skladování.
DROPEFFECT_LINK	4	Je přidán odkaz na položky zdroje k cíli.Zdrojová položka měla odebráni ze zdroje, ale úložiště by mělo zůstat tak, že odkaz není přerušeno.Odkaz je zvláštní případ přesunu.

Hodnoty pwdEffects parametru jsou převzaty z DragDropEffects výčtu.

Viz také

IVsHierarchyDropDataTarget – rozhraní
Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím