IPropertyPageSite

The IPropertyPageSite interface provides the main features for a property page site object. For each property page created within a property frame, the frame creates a property page site to provide information to the property page and to receive notifications from the page when changes occur. This latter notification is used to initiate a call to IPropertyPage::IsPageDirty, the return value of which is then used to enable or disable the frame’s Apply button.

When to Implement

Implement this interface on a site object that will manage a property page on behalf of the property frame. Typically, the OLE-provided property frame created through OleCreatePropertyFrame and OleCreatePropertyFrameIndirect implements site objects.

When to Use

Use a site object with this interface to set up communications between the property frame and the property page object.

Methods in Vtable Order

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

IPropertyPageSite Methods	Description
OnStatusChange	Indicates that the user has modified property values on the property page.
GetLocaleID	Returns the locale identifier so the property page can adjust itself to country-specific settings.
GetPageContainer	Returns an IUnknown pointer for the object representing the entire property frame dialog box that contains all the pages.
TranslateAccelerator	Passes a keystroke to the property frame for processing.

See Also

IPerPropertyBrowsing, IPropertyPage, IPropertyPage2, IPropertyPageSite - Ole Implementation, ISpecifyPropertyPages