Export (0) Print
Expand All

IPropertyPageSite interface

Provides the main features for a property page site object.

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.

Members

The IPropertyPageSite interface inherits from the IUnknown interface. IPropertyPageSite also has these types of members:

Methods

The IPropertyPageSite interface has these methods.

MethodDescription
GetLocaleID

Retrieves the locale identifier (an LCID) that a property page can use to adjust its locale-specific settings.

GetPageContainer

Retrieves a pointer to the object representing the entire property frame dialog box that contains all the pages.

OnStatusChange

Informs the frame that the property page managed by this site has changed its state, that is, one or more property values have been changed in the page.

TranslateAccelerator

Passes a keystroke to the property frame for processing.

 

Remarks

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.

OLE Implementation

The system provides an implementation of the IPropertyPageSite interface through the OleCreatePropertyFrame or OleCreatePropertyFrameIndirect functions. The frame implementation provided through these functions only implements the OnStatusChange and GetLocaleID methods. The GetPageContainer and TranslateAccelerator methods return E_NOTIMPL.

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_IPropertyPageSite is defined as B196B28C-BAB4-101A-B69C-00AA00341D07

See also

IPerPropertyBrowsing
IPropertyPage
IPropertyPage2
ISpecifyPropertyPage

 

 

Community Additions

ADD
Show:
© 2015 Microsoft