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.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.

See Also

IPerPropertyBrowsing, IPropertyPage, IPropertyPageSite, ISpecifyPropertyPages, IPerPropertyBrowsing::MapPropertyToPage