COleClientItem::CreateLinkFromFile

[アーティクル]
02/21/2013

ファイルからリンクされた OLE アイテムを作成するには、この関数を呼び出します。

BOOL CreateLinkFromFile(
   LPCTSTR lpszFileName,
   OLERENDER render = OLERENDER_DRAW,
   CLIPFORMAT cfFormat = 0,
   LPFORMATETC lpFormatEtc = NULL 
);

パラメーター

lpszFileName
OLE アイテムが作成されるファイルの名前へのポインター。
レンダー
サーバーが OLE アイテムを表示する方法を指定することを表すフラグです。有効な値については、Windows SDKの OLERENDER を参照してください。
cfFormat
OLE アイテムを作成するときにキャッシュするクリップボードデータ形式を指定します。
lpFormatEtc
レンダリングがOLERENDER_FORMAT または OLERENDER_DRAWで使用される FORMATETC の構造体へのポインター。cfFormatで指定されたクリップボード形式以外に、追加の書式設定情報を指定する場合にのみ、このパラメーターに値を指定します。このパラメーターを省略すると、既定値は FORMATETC の構造体に他のフィールドに使用されます。

戻り値

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

解説

フレームワークは、ファイルのボタンから作成が選択され、リンクのチェックボックスをオンにすると、ユーザーがの[オブジェクトの挿入]ダイアログボックスの[OK]をクリックしてこの関数を呼び出します。これは COleInsertDialog::CreateItemから呼び出されます。

詳細については、Windows SDKの OleCreateLinkToFile、OLERENDERと FORMATETC を参照してください。

必要条件

ヘッダー : afxole.h

参照

関連項目

COleClientItem クラス

COleInsertDialog::CreateItem