IPropertyPage::Activate method (ocidl.h)

2024-02-22

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

Share via