IDragSourceHelper 인터페이스(shobjidl_core.h)

애플리케이션이 셸 끌어서 놓기 작업 중에 표시할 이미지를 지정할 수 있도록 셸에 의해 노출됩니다.

상속

IDragSourceHelper 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IDragSourceHelper 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IDragSourceHelper 인터페이스에는 이러한 메서드가 있습니다.

IDragSourceHelper::InitializeFromBitmap 창 없는 컨트롤에 대한 끌기 이미지 관리자를 초기화합니다.
IDragSourceHelper::InitializeFromWindow 창을 사용하여 컨트롤에 대한 끌기 이미지 관리자를 초기화합니다.

설명

이 인터페이스는 셸의 끌기 이미지 관리자에 의해 노출됩니다. 애플리케이션에서 구현되지 않습니다.

이 인터페이스를 사용하여 셸 끌어서 놓기 작업 중에 표시되는 이미지를 지정합니다. IDragSourceHelper, IDropTargetHelper 및 IInitializeWithWindow 인터페이스는 IDropTarget 인터페이스가 사용자 지정 끌기 이미지를 사용할 수 있도록 끌기 이미지 관리자 개체에 의해 노출됩니다. 이러한 인터페이스 중 하나를 사용하려면 CLSID_DragDropHelper CLSID(클래스 식별자)를 사용하여 CoCreateInstance 를 호출하여 in-process 서버 끌어오기 이미지 관리자 개체를 만들어야 합니다. 표준 COM(구성 요소 개체 모델) 프로시저를 사용하여 인터페이스 포인터를 가져옵니다.

IDragSourceHelper 인터페이스는 끌기 이미지로 사용할 비트맵을 지정하는 다음 두 가지 방법을 제공합니다.

• 창이 있는 컨트롤은 창에 대한 DI_GETDRAGIMAGE 창 메시지를 등록하고 IDragSourceHelper::InitializeFromWindow를 사용하여 끌기 이미지 관리자를 초기화할 수 있습니다. DI_GETDRAGIMAGE 메시지가 수신되면 처리기는 메시지의 lParam 값으로 전달되는 SHDRAGIMAGE 구조체에 끌어서 놓습니다.
• 창 없는 컨트롤은 IDragSourceHelper::InitializeFromBitmap을 사용하여 끌기 이미지 관리자를 초기화할 수 있습니다. 이 메서드를 사용하면 애플리케이션에서 비트맵을 간단히 지정할 수 있습니다.

참고 끌어서 놓기 도우미 개체는 IDataObject::SetData 를 호출하여 프로세스 간 지원에 사용되는 프라이빗 형식을 데이터 개체에 로드합니다. 나중에 IDataObject::GetData를 호출하여 이러한 형식을 검색합니다. 끌어서 놓기 도우미 개체를 지원하려면 데이터 개체의 SetData 및 GetData 구현에서 임의의 프라이빗 형식을 수락하고 반환할 수 있어야 합니다.

 

셸 끌어서 놓기 작업에 대한 자세한 내용은 끌어서 놓기 또는 클립보드를 사용하여 셸 데이터 전송을 참조하세요.

참고 Windows Vista 이전에는 이 인터페이스가 Shlobj.h로 선언되었습니다.

 

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)