データオブジェクトとデータソース: 作成と破棄

2025-06-19

記事「データオブジェクトとデータソース (OLE)」で説明されているように、データオブジェクトとデータソースはデータ転送の両側を表します。この記事では、次のようなデータ転送を適切に実行するために、これらのオブジェクトとソースを作成および破棄するタイミングについて説明します。

データオブジェクトの作成
データオブジェクトの破棄
データソースの作成
データソースの破棄

データオブジェクトの作成

データオブジェクトは、クライアントまたはサーバーのいずれかの宛先アプリケーションによって使用されます。移行先アプリケーションのデータオブジェクトは、ソースアプリケーションと移行先アプリケーションの間の接続の 1 つの端です。コピー先アプリケーションのデータオブジェクトは、データソース内のデータにアクセスして操作するために使用されます。

データオブジェクトが必要な場合は、2 つの一般的な状況があります。最初の状況は、ドラッグアンドドロップを使用してアプリケーションでデータがドロップされる場合です。 2 つ目の状況は、[編集] メニューから [貼り付け] または [特別な貼り付け] が選択されている場合です。

ドラッグアンドドロップの状況では、データオブジェクトを作成する必要はありません。既存のデータオブジェクトへのポインターが、 OnDrop 関数に渡されます。このデータオブジェクトは、ドラッグアンドドロップ操作の一環としてフレームワークによって作成され、フレームワークによって破棄もされます。貼り付けが別の方法で行われる場合、これは必ずしも当てはまるとは限りません。詳細については、「データオブジェクトの破棄」を参照してください。

アプリケーションで特殊な貼り付け操作または貼り付け操作を実行している場合は、 COleDataObject オブジェクトを作成し、その AttachClipboard メンバー関数を呼び出す必要があります。これにより、データオブジェクトがクリップボード上のデータに関連付けられます。その後、貼り付け関数でこのデータオブジェクトを使用できます。

データオブジェクトの破棄

「データオブジェクトの作成」で説明されているスキームに従う場合、データオブジェクトを破棄することは、データ転送の重要な側面です。貼り付け関数で作成されたデータオブジェクトは、貼り付け関数が返されるときに MFC によって破棄されます。

貼り付け操作を処理する別の方法に従う場合は、貼り付け操作の完了後にデータオブジェクトが破棄されていることを確認します。データオブジェクトが破棄されるまで、アプリケーションがクリップボードにデータを正常にコピーすることはできません。

データソースの作成

データソースは、データ転送のソース (データ転送のクライアント側またはサーバー側) によって使用されます。ソースアプリケーションのデータソースは、ソースアプリケーションと移行先アプリケーションの間の接続の 1 つの端です。コピー先アプリケーションのデータオブジェクトは、データソース内のデータを操作するために使用されます。

データソースは、アプリケーションがクリップボードにデータをコピーする必要があるときに作成されます。一般的なシナリオは次のように実行されます。

ユーザーが一部のデータを選択します。
ユーザーが [編集] メニューから [コピー] (または [切り取り] ) を選択するか、ドラッグアンドドロップ操作を開始します。
アプリケーションは、プログラムの設計に応じて、 COleDataSource オブジェクトまたは COleDataSource から派生したクラスのオブジェクトを作成します。
選択したデータは、 COleDataSource::CacheData または COleDataSource::DelayRenderData グループのいずれかの関数を呼び出すことによって、データソースに挿入されます。
アプリケーションは、手順 3 で作成したオブジェクトに属する SetClipboard メンバー関数 (または、ドラッグアンドドロップ操作の場合は DoDragDrop メンバー関数) を呼び出します。
切り取り操作の場合、またはDoDragDropがDROPEFFECT_MOVEを返す場合、手順 1 で選択したデータはドキュメントから削除されます。

このシナリオは、MFC OLE サンプル OCLIENT と HIERSVR によって実装されます。 CView関数とGetClipboardData関数以外のすべてのアプリケーションのOnGetClipboardData派生クラスのソースを確認します。これら 2 つの関数は、 COleClientItem または COleServerItem派生クラスの実装にあります。これらのサンプルプログラムは、これらの概念を実装する方法の良い例を提供します。

ドラッグアンドドロップ操作の既定の動作を変更する場合は、 COleDataSource オブジェクトを作成する必要があるもう 1 つの状況が発生します。詳細については、「 OLE ドラッグアンドドロップ: ドラッグアンドドロップのカスタマイズ」の記事を参照してください。

データソースの破棄

データソースは、現在そのデータソースを担当しているアプリケーションによって破棄される必要があります。 COleDataSource::D oDragDrop の呼び出しなど、データソースを OLE に渡す場合は、pDataSrc->InternalReleaseを呼び出す必要があります。例えば次が挙げられます。

void CMyListView::OnLvnBegindrag(NMHDR *pNMHDR, LRESULT *pResult)
{
   UNREFERENCED_PARAMETER(pResult);

   LPNMLISTVIEW pNMLV = reinterpret_cast<LPNMLISTVIEW>(pNMHDR);

   CMyDataSource* pDataSrc = new CMyDataSource();
   if (NULL != pDataSrc)
   {
      pDataSrc->Initialize(pNMLV, this);
      pDataSrc->DelayRenderData((CLIPFORMAT)RegisterClipboardFormat(_T("TIGroupFiles")));
      pDataSrc->DoDragDrop();
      pDataSrc->InternalRelease();
   }
}

データソースを OLE に渡していない場合は、一般的な C++ オブジェクトと同様に、データソースを破棄する必要があります。

詳細については、「ドラッグアンドドロップ、クリップボード、およびデータオブジェクトとデータソースの操作」を参照してください。

こちらも参照ください

データオブジェクトとデータソース (OLE)
COleDataObject クラス
 COleDataSource クラス

次の方法で共有

データ オブジェクトとデータ ソース: 作成と破棄

データ オブジェクトの作成

データ オブジェクトの破棄

データ ソースの作成

データ ソースの破棄