IPropertyPage::Activate method (ocidl.h)

  • Article

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

[in] hWndParent

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

[in] pRect

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.

[in] bModal

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.

Return code Description
S_OK
 The method completed successfully.
E_POINTER
 The address in prc is not valid. For example, it may be NULL.

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ocidl.h

See also

IPropertyPage