Share via


Windows Media Player 11 SDK About the Property Page Object (deprecated) 

Windows Media Player SDK banner art

Previous Next

About the Property Page Object (deprecated)

This page documents a feature that may be unavailable in future versions of Windows Media Player and the Windows Media Player SDK.

The property page object is a COM object that implements the IPropertyPage interface. The sample code generated by the plug-in wizard uses the ATL implementation of IPropertyPage, which is documented in the Visual C++ documentation on MSDN. Your code at least should provide override implementations for IPropertyPage::OnInitDialog, which handles the event that occurs when the property page opens, and IPropertyPage::Apply, which handles the event that occurs when the user clicks Apply. The plug-in wizard generates sample code for each of these event handlers. The sample implementation of OnInitDialog retrieves a value from the registry to display the current text color setting. The sample implementation of Apply persists the value to the registry and then passes the value to the rendering plug-in property put method, named put_color.

Additionally, you will need to add code to handle the event that occurs when the user changes a value in a control you provide in the property page. For example, the plug-in wizard implements three functions named OnClickedBlue, OnClickedRed, and OnClickedGreen. When the user clicks a radio button on the property page, these are the events that cache the color value and then enable the Apply button by calling the SetDirty method with an argument value of TRUE.

See Also

Previous Next