IPropertyPage2 Interface

IID_IPropertyPage2

{01E44665-24AC-101B-84ED-08002B2EC713}

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.

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

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

EditProperty

FUNCTION IPropertyPage2_EditProperty ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL dispID AS LONG _

  ) AS LONG
 

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[14] USING IPropertyPage2_EditProperty (pthis, dispID) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION