IPropertyPage::Activate method

Creates the dialog box window for the property page.

The dialog box is created without a frame, caption, or system menu/controls. The text in the dialog should match the locale obtained through IPropertyPageSite::GetLocaleID.

Syntax

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

Parameters

hWndParent [in]

The window handle of the parent of the dialog box that is being created.

pRect [in]

A pointer to the RECT structure containing the positioning information for the dialog box. This method must create its dialog box with the placement and dimensions described by this structure.

bModal [in]

Indicates whether the dialog box frame is modal (TRUE) or modeless (FALSE).

Return value

This method can return the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following values.

Remarks

The property page maintains the window handle created in this process, which it uses to destroy the dialog box within IPropertyPage::Deactivate.

Notes to Implementers

E_NOTIMPL is not a valid return value.

Requirements

See also

IPropertyPage