COleClientItem::CreateFromFile
更新 : 2007 年 11 月
ファイルを使って埋め込みアイテムを作成します。
BOOL CreateFromFile(
LPCTSTR lpszFileName,
REFCLSID clsid = CLSID_NULL,
OLERENDER render = OLERENDER_DRAW,
CLIPFORMAT cfFormat = 0,
LPFORMATETC lpFormatEtc = NULL
);
パラメータ
lpszFileName
OLE アイテムを作成するのに使われるファイル名へのポインタ。clsid
将来使用するために予約されています。render
サーバーが OLE アイテムを描画する方法を指定するフラグ。指定する値については、Windows SDK の「OLERENDER」を参照してください。cfFormat
OLE アイテムの作成時にキャッシュされるクリップボード データの形式。lpFormatEtc
render が OLERENDER_FORMAT または OLERENDER_DRAW のときに使用される FORMATETC 構造体へのポインタ。cfFormat で指定されたクリップボード形式に対して付加形式情報を指定する場合だけ、このパラメータを指定します。このパラメータを省略すると、FORMATETC 構造体のほかのフィールドには既定の値が使われます。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
ユーザーが [オブジェクトの挿入] ダイアログ ボックスで、[ファイルから作成] をクリックし、[OK] をクリックすると、フレームワークは COleInsertDialog::CreateItem からこの関数を呼び出します。
詳細については、Windows SDK の「OleCreateFromFile」、「OLERENDER」および「FORMATETC」を参照してください。
必要条件
ヘッダー : afxole.h