OleCreatePropertyFrame 関数 (olectl.h)

新しいプロパティ フレーム (つまり、親が hwndOwner) のプロパティ シート ダイアログ ボックスを呼び出します。このダイアログ ボックスは、親ウィンドウ内のポイント (x,y) に配置され、lpszCaption キャプションを持ちます。

構文

WINOLECTLAPI OleCreatePropertyFrame(
  [in] HWND      hwndOwner,
  [in] UINT      x,
  [in] UINT      y,
  [in] LPCOLESTR lpszCaption,
  [in] ULONG     cObjects,
  [in] LPUNKNOWN *ppUnk,
  [in] ULONG     cPages,
  [in] LPCLSID   pPageClsID,
  [in] LCID      lcid,
  [in] DWORD     dwReserved,
  [in] LPVOID    pvReserved
);

パラメーター

[in] hwndOwner

結果のプロパティ シート ダイアログ ボックスの親ウィンドウを処理します。

[in] x

予約済み。 hwndOwner に対するダイアログ ボックスの水平方向の位置。

[in] y

予約済み。 hwndOwner を基準としたダイアログ ボックスの垂直方向の位置。

[in] lpszCaption

ダイアログ ボックスのキャプションに使用される文字列へのポインター。

[in] cObjects

ppUnk で渡されるオブジェクト ポインターの数。

[in] ppUnk

このプロパティ シートが呼び出されているオブジェクト上の IUnknown ポインターの配列。 配列内の要素の数は 、cObjects によって指定されます。 これらのポインターは、 IPropertyPage::SetObjects を介して各プロパティ ページに渡されます。

[in] cPages

pPageCIsID で指定されたプロパティ ページの数。

[in] pPageClsID

プロパティ シートに表示する各プロパティ ページの CLSCD を含む サイズ cPage の配列。

[in] lcid

プロパティ シートに使用するロケール識別子。 プロパティ ページは、 IPropertyPageSite::GetLocaleID を使用してこの識別子を取得できます。

[in] dwReserved

今後使用するために予約されています。0 にする必要があります。

[in] pvReserved

将来の使用のために予約されています。 は NULL である必要があります。

戻り値

この関数は、E_INVALIDARG、E_OUTOFMEMORY、およびE_UNEXPECTEDの標準戻り値と、次の値をサポートします。

リターン コード	説明
S_OK	ダイアログ ボックスが呼び出され、正常に操作されました。
E_POINTER	lpszCaption、ppUnk、または pPageCIsID のアドレスが無効です。 たとえば、いずれか 1 つが NULL である可能性があります。

注釈

表示されるプロパティ ページは 、cPages CLSID 値の配列である pPageClsIDで 識別されます。 このプロパティ シートの影響を受けるオブジェクトは、iUnknown ポインターを含むサイズ cObjects の配列である ppUnk で識別されます。

この関数は常にモーダル ダイアログ ボックスを作成し、ダイアログ ボックスが閉じられるまで戻りません。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	olectl.h
Library	OleAut32.lib
[DLL]	OleAut32.dll

こちらもご覧ください

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID