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.
| Method | Description |
|---|---|
| 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 |
|
|
IDL |
|
|
IID |
IID_IPropertyPageSite is defined as B196B28C-BAB4-101A-B69C-00AA00341D07 |
See also