IPropertyPage::Activate メソッド (ocidl.h)

プロパティページのダイアログボックスウィンドウを作成します。

ダイアログボックスは、フレーム、キャプション、またはシステムメニュー/コントロールなしで作成されます。ダイアログ内のテキストは、 IPropertyPageSite::GetLocaleID によって取得されたロケールと一致している必要があります。

構文

HRESULT Activate(
  [in] HWND    hWndParent,
  [in] LPCRECT pRect,
  [in] BOOL    bModal
);

[in] hWndParent

作成されるダイアログボックスの親のウィンドウハンドル。

[in] pRect

ダイアログボックスの位置情報を含む RECT 構造体へのポインター。このメソッドは、この構造体で記述された配置と寸法を含むダイアログボックスを作成する必要があります。

[in] bModal

ダイアログボックスフレームがモーダル (TRUE) かモードレス (FALSE) かを示します。

このメソッドは、E_OUTOFMEMORYおよびE_UNEXPECTED標準の戻り値と、次の値を返すことができます。

リターンコード	説明
S_OK	メソッドは正常に完了しました。
E_POINTER	prc 内のアドレスが無効です。たとえば、 NULL にすることができます。

プロパティページは、このプロセスで作成されたウィンドウハンドルを保持します。このハンドルを使用して、IPropertyPage::D eactivate 内のダイアログボックスを破棄します。

E_NOTIMPLは有効な戻り値ではありません。

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