DROPEFFECT_NONE    0
DROPEFFECT_COPY    1
DROPEFFECT_MOVE    2
DROPEFFECT_LINK    4
DROPEFFECT_SCROLL  0x80000000

ドラッグ＆ドロップしたときに、オリジナルをコピーするか、移動するか、
拒否するかを識別します。

ドロップを拒否します
コピーします
移動します（オリジナルを削除します）
リンクを作成します
(*1)

(*1) COleDataSource::DoDragDrop で、ドラッグスクロールを許可します（？）

以下の関数で使われます。

CView::OnDragEnter
CView::OnDragOver
CView::OnDrop

UINT  RegisterClipboardFormat( TSTR* format );

アプリケーション独自のクリップボードの形式を文字列で指定し、識別に使う値を返します。

クリップボードの型の識別に使う値 0xC000〜0xFFFF

format は、大文字と小文字を区別しません。
同じ文字列を指定したら、同じ値が返ります。 ただし、OSを再起動すると変わる可能性はあります。

【引数】

format

返り値

クリップボードの型の名前

【補足】

MSDN(Web)

int  GetClipboardFormatName( UINT num, TSTR* name, int name_size );

クリップボードの形式の数値から、形式の名前（文字列）を取得します。

（出力）クリップボードの名前を格納するアドレス

【引数】

num

name

クリップボードの型の識別に使う値

name_size

name のメモリサイズ（バイト）

成功=文字数、失敗=0

返り値

MSDN(Web)

UINT  EnumClipboardFormats( UINT format );

クリップボードに入っているすべてのデータ形式を取得します。

【引数】

format

前回取得したデータ形式値、最初は 0

返り値

次のデータ形式値

CF_TEXT などの値や、

RegisterClipboardFormat

で取得できる値が返ります。

クリップボードには、複数の形式のデータが格納されていることが多いです。
次のサンプルように、すべてのデータ形式を調べて、動作内容を決定してください。

HANDLE  GetClipboardData( UINT format );

クリップボードにあるデータのうち、指定の形式のデータのハンドルを取得します。

HGLOBAL  GlobalAlloc( UINT flags, size_t size );

MSDN(Web)

flags

通常 0

【引数】

size

グローバルメモリ（他のプロセスからでもアクセスできるメモリ領域）を確保します。

確保するメモリサイズ（バイト）

返り値

グローバルメモリへのハンドル

【補足】

確保したメモリ領域は、返り値を

して初めてアクセスできます。

GlobalLock

使わなくなったら、返り値を

GlobalFree

してください。

HGLOBAL  GlobalFree( HGLOBAL mem );

mem

【引数】

で確保した、グローバルメモリを開放します。

返り値

グローバルメモリへのハンドル

成功=NULL

GlobalAlloc

void*  GlobalLock( HGLOBAL mem );

mem

【引数】

グローバルメモリへのアクセスを開始します。

返り値

グローバルメモリへのハンドル

グローバルメモリにアクセスできるアドレス

MSDN(Web)

【補足】

使わなくなったら、mem 引数を

GlobalUnlock

してください。

アクセスできる範囲は、

GlobalSize

から分かります。

BOOL  GlobalUnlock( HGLOBAL mem );

mem

【引数】

で開始した、グローバルメモリへのアクセスを終了します。

返り値

グローバルメモリへのハンドル

成功 = NO_ERROR

GlobalLock

MSDN(Web)

DWORD  GlobalSize( HGLOBAL mem );

MSDN(Web)

mem

【引数】

で確保した、グローバルメモリのサイズを返します。

返り値

グローバルメモリへのハンドル

グローバルメモリのサイズ（バイト）

GlobalAlloc

GetData
GetDataHere
QueryGetData
GetCanonicalFormatEtc
SetData
EnumFormatEtc
DAdvise
DUnadvise
EnumDAdvise

MFC の OLEドラッグ＆ドロップ

CLIPFORMAT  m_DropType;
DROPEFFECT  m_DropEffectDef;
DROPEFFECT  m_DropEffectMask;


DROPEFFECT CView::OnDragEnter( COleDataObject* pDataObject, DWORD KeyState, CPoint point )
{
  bool  bTextFormat, bFileFormat;

  /* 種類の存在を確認する */
  pDataObject->BeginEnumFormats();
  while ( pDataObject->GetNextFormat( &f ) ) {
    if ( f.cfFormat == CF_TEXT )  bTextFormat = true;
    if ( f.cfFormat == CF_HDROP )  bFileFormat = true;
  }

  /* 種類の存在から対応する処理のタイプを決める */
  if ( bTextFormat )  m_DropType = CF_TEXT;

  /* effect（コピーか移動か拒否か）のデフォルトとマスクを設定する */
  switch ( m_DropType ) {
    case  CF_TEXT:
      m_DropEffectDef = DROPEFFECT_MOVE;
      m_DropEffectMask = DROPEFFECT_MOVE | DROPEFFECT_COPY;
      break;
    default:
      m_DropEffectDef = DROPEFFECT_NONE;
      m_DropEffectMask = 0;
      break;
  }

  /* 現在の effect を返す（CView::OnDragOver でも同様に） */
  switch ( dwKeyState & (MK_CONTROL | MK_SHIFT) ) {
    case  MK_SHIFT:    ret = DROPEFFECT_MOVE;  break;
    case  MK_CONTROL:  ret = DROPEFFECT_COPY;  break;
    case  ( MK_SHIFT | MK_CONTROL ):
                       ret = DROPEFFECT_LINK;  break;
    case  default:     ret = m_DropEffectDef;  break;
  }
  if ( ( ret & m_DropEffectMask ) == 0 )
    ret = m_DropEffectDef;

  return  ret;
}

[ 親: CView::OnDragEnter ]

typedef struct tagFORMATETC {
    CLIPFORMAT cfFormat;
    DVTARGETDEVICE * ptd;
    DWORD dwAspect;
    LONG lindex;
    DWORD tymed;
} FORMATETC, *LPFORMATETC;

OLEデータの型を識別する構造体です。

EnumClipboardFormats で取得できる形式の値

不明

typedef struct _FILEGROUPDESCRIPTOR {
    UINT cItems;
    FILEDESCRIPTOR fgd[1];
} FILEGROUPDESCRIPTOR, *LPFILEGROUPDESCRIPTOR;

vs2005-help

shlobj.h