Property Pages

Property pages display the current values of specific OLE control properties in a customizable, graphical interface for viewing and editing by supporting a data-mapping mechanism based on dialog data exchange (DDX).

This data-mapping mechanism maps property page controls to the individual properties of the OLE control. The value of the control property reflects the status or content of the property page control. The mapping between property page controls and properties is specified by DDP_ function calls in the property page's DoDataExchange member function. The following is a list of DDP_ functions that exchange data entered using the property page of your control:

Property Page Data Transfer

DDP_CBIndex Use this function to link the selected string's index in a combo box with a control's property.
DDP_CBString Use this function to link the selected string in a combo box with a control's property. The selected string can begin with the same letters as the property's value but need not match it fully.
DDP_CBStringExact Use this function to link the selected string in a combo box with a control's property. The selected string and the property's string value must match exactly.
DDP_Check Use this function to link a check box in the control's property page with a control's property.
DDP_LBIndex Use this function to link the selected string's index in a list box with a control's property.
DDP_LBString Use this function to link the selected string in a list box with a control's property. The selected string can begin with the same letters as the property's value but need not match it fully.
DDP_LBStringExact Use this function to link the selected string in a list box with a control's property. The selected string and the property's string value must match exactly.
DDP_PostProcessing Use this function to finish the transfer of property values from your control.
DDP_Radio Use this function to link a radio button group in the control's property page with a control's property.
DDP_Text Use this function to link a control in the control's property page with a control's property. This function handles several different types of properties, such as double, short, BSTR, and long.

For more information about the DoDataExchange function and property pages, see the article ActiveX Controls: Property Pages in Visual C++ Programmer's Guide.

The following is a list of macros used to create and manage property pages for an OLE control:

Property Pages

BEGIN_PROPPAGEIDS Begins the list of property page IDs.
END_PROPPAGEIDS Ends the list of property page IDs.
PROPPAGEID Declares a property page of the control class.