Interfaccia IDragSourceHelper (shobjidl_core.h)

Esposto da Shell per consentire a un'applicazione di specificare l'immagine che verrà visualizzata durante un'operazione di trascinamento della shell.

Ereditarietà

L'interfaccia IDragSourceHelper eredita dall'interfaccia IUnknown . IDragSourceHelper include anche questi tipi di membri:

Metodi

L'interfaccia IDragSourceHelper include questi metodi.

IDragSourceHelper::InitializeFromBitmap Inizializza il gestore di immagini di trascinamento per un controllo senza finestre.
IDragSourceHelper::InitializeFromWindow Inizializza il gestore immagini di trascinamento per un controllo con una finestra.

Commenti

Questa interfaccia viene esposta dal gestore di trascinamento dell'immagine della Shell. Non viene implementato dalle applicazioni.

Usare questa interfaccia per specificare l'immagine visualizzata durante un'operazione di trascinamento della shell. Le interfacce IDragSourceHelper, IDropTargetHelper e IInitializeWithWindow vengono esposte dall'oggetto gestione immagini di trascinamento per consentire all'interfaccia IDropTarget di usare immagini di trascinamento personalizzate. Per usare una di queste interfacce, è necessario creare un oggetto di gestione trascinamento dell'immagine del server in-process chiamando CoCreateInstance con un identificatore di classe (CLSID) di CLSID_DragDropHelper. Ottenere puntatori di interfaccia usando le procedure COM (Component Object Model) standard.

L'interfaccia IDragSourceHelper fornisce i due modi seguenti per specificare la bitmap da usare come immagine di trascinamento.

• I controlli che dispongono di una finestra possono registrare un messaggio di finestra DI_GETDRAGIMAGE e inizializzare il gestore di immagini di trascinamento con IDragSourceHelper::InitializeFromWindow. Quando viene ricevuto il messaggio DI_GETDRAGIMAGE, il gestore inserisce le informazioni bitmap dell'immagine di trascinamento nella struttura SHDRAGIMAGE passata come valore lParam del messaggio.
• I controlli senza finestra possono inizializzare la gestione immagini di trascinamento con IDragSourceHelper::InitializeFromBitmap. Questo metodo consente a un'applicazione di specificare semplicemente la bitmap.

Nota L'oggetto helper drag-and-drop chiama IDataObject::SetData per caricare i formati privati, usati per il supporto tra processi, nell'oggetto dati. In seguito recupera questi formati chiamando IDataObject::GetData. Per supportare l'oggetto helper drag-and-drop, le implementazioni SetData e GetData dell'oggetto dati devono essere in grado di accettare e restituire formati privati arbitrari.

 

Per altre discussioni sulle operazioni di trascinamento della shell, vedere Trasferimento dei dati della shell tramite trascinamento o selezione degli Appunti.

Nota Prima di Windows Vista questa interfaccia è stata dichiarata in Shlobj.h.

 

Requisiti

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)