Export (0) Print
Expand All

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.

Return codeDescription
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IPropertyPage is defined as B196B28D-BAB4-101A-B69C-00AA00341D07

See also

IPropertyPage

 

 

Community Additions

ADD
Show:
© 2014 Microsoft