COleClientItem::CreateNewItem

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

埋め込みアイテムを作成するには、この関数を呼び出します。; この関数は、ユーザーが OLE アイテムを作成できるようにするサーバーアプリケーションを起動します。

BOOL CreateNewItem(
   REFCLSID clsid,
   OLERENDER render = OLERENDER_DRAW,
   CLIPFORMAT cfFormat = 0,
   LPFORMATETC lpFormatEtc = NULL 
);

パラメーター

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

戻り値

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

解説

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

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

必要条件

ヘッダー : afxole.h

参照

関連項目

COleClientItem クラス

COleInsertDialog::CreateItem