OLEUIINSERTOBJECTA 構造体 (oledlg.h)

  • [アーティクル]

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

構文

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

メンバー

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 の場合、ライブラリは Insert オブジェクトを使用します。

lpfnHook

ダイアログ ボックス用のメッセージを処理するフック関数へのポインター。 フック関数は、処理されなかったメッセージをライブラリのダイアログ ボックス プロシージャに渡すには、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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

OleUIInsertObject