COleClientItem::CreateLinkFromData

更新 : 2007 年 11 月

COleDataObject オブジェクトを使ってリンク アイテムを作成します。

BOOL CreateLinkFromData(
   COleDataObject* pDataObject,
   OLERENDER render = OLERENDER_DRAW,
   CLIPFORMAT cfFormat = 0,
   LPFORMATETC lpFormatEtc = NULL 
);

パラメータ

  • pDataObject
    OLE アイテムを作成するのに使われる COleDataObject オブジェクトへのポインタ。

  • render
    サーバーが OLE アイテムを描画する方法を指定するフラグ。指定する値については、Windows SDK の「OLERENDER」を参照してください。

  • cfFormat
    OLE アイテムの作成時にキャッシュされるクリップボード データの形式。

  • lpFormatEtc
    renderOLERENDER_FORMAT または OLERENDER_DRAW のときに使用される FORMATETC 構造体へのポインタ。cfFormat で指定されたクリップボード形式に対して付加形式情報を指定する場合だけ、このパラメータを指定します。このパラメータを省略すると、FORMATETC 構造体のほかのフィールドには既定の値が使われます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ユーザーがリンクの作成を指定すると、ドロップ操作中にこの関数が呼び出されます。[編集] メニューの [貼り付け] コマンドの処理にも使われます。フレームワークは、[リンク] オプション ボタンが選択されていると、COleClientItem::CreateLinkFromClipboard 関数と COlePasteSpecialDialog::CreateItem 関数の中でこの関数を呼び出します。

詳細については、Windows SDK の「OleCreateLinkFromData」、「OLERENDER」および「FORMATETC」を参照してください。

必要条件

ヘッダー : afxole.h

参照

参照

COleClientItem クラス

階層図

COleDataObject::AttachClipboard

COleDataObject クラス

COleClientItem::CreateLinkFromClipboard

その他の技術情報

COleClientItem のメンバ