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. |