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

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

[in] lcid

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

[in] dwReserved

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

[in] pvReserved

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

戻り値

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

備考

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

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

必要条件

関連項目

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID