RAD Studio VCL Reference
TPropertyPage Class

TPropertyPage is the base class for controls that represent an ActiveX control's property page.

TPropertyPage = class(TCustomForm);
class TPropertyPage : public TCustomForm;

TPropertyPage extends TCustomForm by adding the functionality needed to embed the form in an ActiveX property page dialog. It also adds methods to copy property values from the object to the form's controls, and vice versa. 

To implement your own property page for an ActiveX object, derive a new class from TPropertyPage, design the form, then override the UpdateObject and UpdatePropertyPage methods. The IDE provides an expert for creating a skeleton property page. See Creating a new property page for more information. 

TPropertyPage provides a helper method, Modified, that your form can call when any of the controls on the form are changed by the user. Calling the Modified method notifies the property dialog that the user has modified the object's properties. Normally this will enable the Apply button on the property dialog. 

The property page maintains a connection to the object it is editing, using the OleObject or OleObjects property. This property is a Variant and can be used to read and write the object's properties. 


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!