IPropertyPage2

The IPropertyPage2 interface is an extension to IPropertyPage to support initial selection of a property on a page. It works in conjunction with the implementation of IPerPropertyBrowsing::MapPropertyToPage on an object that supplies properties and specifies property pages through ISpecifyPropertyPages. This interface has only one extra method in addition to those in IPropertyPage. That method, IPropertyPage2::EditProperty tells the page which property to highlight.

When to Implement

Implement this interface if your property page object supports selection of a specific property.

When to Use

Use this interface to select a specific property in a property page.

Methods in Vtable Order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IPropertyPage Methods

Description

SetPageSite

Initializes a property page and provides the page with a pointer to the IPropertyPageSite interface through which the property page communicates with the property frame.

Activate

Creates the dialog box window for the property page.

Deactivate

Destroys the window created with Activate.

GetPageInfo

Returns information about the property page.

SetObjects

Provides the property page with an array of IUnknown pointers for objects associated with this property page.

Show

Makes the property page dialog box visible or invisible.

Move

Positions and resizes the property page dialog box within the frame.

IsPageDirty

Indicates whether the property page has changed since activated or since the most recent call to Apply.

Apply

Applies current property page values to underlying objects specified through SetObjects.

Help

Invokes help in response to end-user request.

TranslateAccelerator

Provides a pointer to a MSG structure that specifies a keystroke to process.

IPropertyPage2 Methods

Description

EditProperty

Specifies which field is to receive the focus when the property page is activated.

IUnknown Methods	Description
QueryInterface	Returns pointers to supported interfaces.
AddRef	Increments reference count.
Release	Decrements reference count.

IPropertyPage Methods	Description
SetPageSite	Initializes a property page and provides the page with a pointer to the IPropertyPageSite interface through which the property page communicates with the property frame.
Activate	Creates the dialog box window for the property page.
Deactivate	Destroys the window created with Activate.
GetPageInfo	Returns information about the property page.
SetObjects	Provides the property page with an array of IUnknown pointers for objects associated with this property page.
Show	Makes the property page dialog box visible or invisible.
Move	Positions and resizes the property page dialog box within the frame.
IsPageDirty	Indicates whether the property page has changed since activated or since the most recent call to Apply.
Apply	Applies current property page values to underlying objects specified through SetObjects.
Help	Invokes help in response to end-user request.
TranslateAccelerator	Provides a pointer to a MSG structure that specifies a keystroke to process.

IPropertyPage2 Methods	Description
EditProperty	Specifies which field is to receive the focus when the property page is activated.