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 を含む サイズ 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 ポインターを含む サイズ cObject の 配列である ppUnk で 識別されます。

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

要件

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

こちらもご覧ください

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID