DGDragSetDelayedData

지정한 포맷과 범위를 가진 지연된 드래그 앤 드롭 데이터를 세트합니다.

    bool DGDragSetDelayedData (
      DGDragFormat  format,
      short         scope
    );

파라미터

format

Int32 값입니다. 보통 문자 표현으로 사용됩니다. ('FILE', 'TEXT') 드롭된 드래그 데이터의 포맷을 식별하는 데 사용합니다.

 

scope

드래그 앤 드롭 동작의 범위입니다. 주어진 범위 밖에서 이 데이터는 명시적으로 거부됩니다. 범위는 다음 값들을 가질 수 있습니다: DG_DRAG_SCOPE_ITEM, DG_DRAG_SCOPE_DIALOG, DG_DRAG_SCOPE_MODULE, DG_DRAG_SCOPE_APP, DG_DRAG_SCOPE_SYSTEM

리턴 값

지연된 데이터 포맷이 성공적으로 세트되면 true입니다. 그 외에는 false입니다.

설명

DGDragSetData 함수로 드래그 앤 드롭 동작에 대한 사용자 정의 데이터 블록들을 설정할 수 있는 가능성이 있습니다. 데이터 블록은 포맷을 갖고 있습니다. 이것은 Int32 값이며 이 블록의 데이터 포맷을 설명합니다. 이 포맷은 추가된 데이터 블록들의 포맷들 중에서 유일해야 합니다. 그래서 이미 존재하는 포맷으로 데이터 블록을 설정할 수 없습니다. 보통 이 블록은 드래그된 항목들, 지정된 포맷의 엔티티(또는 그에 대한 레퍼런스)들을 포함하고 있습니다.

필요한 경우 데이터 블록의 설정은 지연될 수 있습니다: DGDragSetData 대신 DGDragSetDelayedData 함수를 호출해야 합니다. 그리고 DG_DRAG_SETDELAYEDDATA 서브 메시지가 온 다음에 DGDragSetData로 데이터 블록을 세트해야 합니다.

절대적으로 필요할 때에만 할당된 드래그 앤 드롭 데이터를 세트하기 위해 이 함수를 호출하십시오. 드래그 앤 드롭 동작 도중 다량의 데이터를 전달할 때 이것은 매우 유용할 수 있습니다.

드래그 대상이 지연된 드래그 포맷을 가지고 DGDragGetData를 호출할 때, 드래그 관리자는 드래그 소스에게 DG_DRAG_SETDELAYEDDATA 메시지를 보냅니다. 그러면 드래그 소스는 반드시 DGDragSetData 함수로 드래그 앤 드롭 데이터를 세트해야 합니다.

요구사항

버전: DG 2.0.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG_MSG_DRAGDROP, DGDragGetData, DGDragHasFormat
빌트인 드래그 포맷, DGDragSetData, DGDragModifyBaseFormat