次の方法で共有

OLEUIINSERTOBJECTW 構造体 (oledlg.h)

  • [アーティクル]

OLE ユーザー インターフェイス ライブラリが [オブジェクト の挿入] ダイアログ ボックス 初期化するために使用する情報と、ダイアログ ボックスを閉じるときにライブラリが情報を返す領域を格納します。

構文

typedef struct tagOLEUIINSERTOBJECTW {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCWSTR         lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCWSTR         lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPWSTR          lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;

メンバーズ

cbStruct

構造体のサイズ (バイト単位)。 このフィールドは入力時に入力する必要があります。

dwFlags

入力時に、初期化フラグと作成フラグを指定します。 終了時に、ユーザーの選択肢を指定します。 次のフラグを組み合わせて使用できます。

価値 意味
IOF_SHOWHELP
 ダイアログ ボックスに、ヘルプ ボタンが表示されます。
IOF_SELECTCREATENEW
 新規作成 オプション ボタンが最初にオンになります。 これは、IOF_SELECTCREATEFROMFILEでは使用できません。
IOF_SELECTCREATEFROMFILE
 [ファイルから作成] オプション ボタンが最初にオンになります。 これは、IOF_SELECTCREATENEWでは使用できません。
IOF_CHECKLINK
 [リンク] チェック ボックスが最初にオンになります。
IOF_CHECKDISPLAYASICON
 [アイコンとして表示] チェック ボックスが最初にオンになり、現在のアイコンが表示され、[アイコンの変更] ボタンが有効になります。
IOF_CREATENEWOBJECT
 ユーザーが [OK] 選択してダイアログ ボックスを閉じ、[新規作成] ラジオ ボタンが選択されたときに、新しいオブジェクトを作成する必要があります。
IOF_CREATEFILEOBJECT
 ユーザーが [OK] を選択してダイアログ ボックスを閉じ、[ファイルから作成] ラジオ ボタンが選択されている場合は、指定したファイルから新しいオブジェクトを作成する必要があります。
IOF_CREATELINKOBJECT
 ユーザーが [OK] 選択してダイアログ ボックスを閉じ、ユーザーが [リンク] チェック ボックスをオンにした場合は、新しいリンク オブジェクトを作成する必要があります。
IOF_DISABLELINK
 [リンク] チェック ボックスは、初期化時に無効になります。
IOF_VERIFYSERVERSEXIST
 ダイアログ ボックスでは、登録データベースで指定されたサーバーが存在することを確認して、リスト ボックスに追加するクラスを検証する必要があります。 これは重要なパフォーマンス要因です。
IOF_DISABLEDISPLAYASICON
 初期化時に[アイコン として表示]チェック ボックスは無効になります。
IOF_HIDECHANGEICON
 [変更アイコン] ボタンは、[オブジェクト の挿入] ダイアログ ボックス 非表示になります。
IOF_SHOWINSERTCONTROL
 [コントロールの挿入] ラジオ ボタン 表示します。
IOF_SELECTCREATECONTROL
 コントロールの作成 オプション ボタンを表示します。

hWndOwner

ダイアログ ボックスを所有するウィンドウ。 このメンバーは NULLしないでください。

lpszCaption

ダイアログ ボックスのタイトルとして使用する文字列へのポインター。 null場合、ライブラリは オブジェクトの挿入を使用します。

lpfnHook

ダイアログ ボックス用のメッセージを処理するフック関数へのポインター。 hook 関数は、ライブラリのダイアログ ボックス プロシージャに処理されなかったというメッセージを渡すために 0 を返す必要があります。 フック関数は、ライブラリのダイアログ ボックス プロシージャが既に処理しているメッセージを処理しないように、0 以外の値を返す必要があります。

lCustData

lpfnHook メンバーが指すフック関数にライブラリが渡すアプリケーション定義データ。 ライブラリは、WM_INITDIALOG メッセージの lParam パラメーター内の OLEUIINSERTOBJECT 構造体へのポインターを渡します。このポインターを使用して、lCustData メンバーを取得できます。

hInstance

lpTemplateName メンバーによって指定されたダイアログ ボックス テンプレートを含むインスタンス。

lpszTemplate

ライブラリの [オブジェクトの挿入] ダイアログ ボックス テンプレートに置き換えるダイアログ ボックス テンプレートのリソース ファイル の名前を指定する null で終わる文字列へのポインター。

hResource

カスタマイズされたテンプレート ハンドル。

clsid

挿入するオブジェクトのクラスの CLSID。 出力時に入力されます。

lpszFile

リンクまたは埋め込むファイルの名前へのポインター。 出力時に入力されます。

cchFile

lpszFile バッファーのサイズ。はMAX_PATHを超えなくなります。

cClsidExclude

lpClsidExclude リストに含まれる CLSID の数。 入力時に入力されます。

lpClsidExclude

リストから除外する CLSID のリストへのポインター。

iid

要求されたインターフェイスの識別子。 OleUIInsertObject オブジェクトを作成すると、このインターフェイスへのポインターが返されます。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

oleRender

レンダリング オプション。 OleUIInsertObject オブジェクトを作成する場合は、オブジェクトの作成時にレンダリング オプションを選択します。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

lpFormatEtc

目的の形式。 OleUIInsertObject オブジェクトを作成する場合は、オブジェクトの作成時に形式を選択します。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

lpIOleClientSite

オブジェクトに使用するクライアント サイトへのポインター。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

lpIStorage

オブジェクトに使用するストレージへのポインター。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

ppvObj

挿入されるオブジェクトのインターフェイス ポインターを含む出力ポインター変数のアドレス。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

sc

作成呼び出しの結果。 OleUIInsertObject オブジェクトが作成されない場合、このパラメーターは無視されます。

hMetaPict

オブジェクトのキャッシュに配置されていない場合は、象徴的な側面を含む MetafilePict 構造体。

備考

手記

oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUIINSERTOBJECT を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー oledlg.h

関連項目

OleUIInsertObject の