getPropertyDisplay(property: String;
str: String io): Boolean;
The getPropertyDisplay method of the Window class is primarily for use with ActiveX controls and user-defined controls, where the ActiveX or user-defined control is requested to return its textual representation of a property value.
The parameters of the getPropertyDisplay method are listed in the following table.
| Parameter | Description |
|---|---|
| property | Name of the property being requested |
| str | Returned string representation |
The return values of the getPropertyDisplay method are listed in the following table.
| Value | Description |
|---|---|
| true | The str parameter contains the property string text |
| false | Not implemented for this property |
The getPropertyDisplay method is called by the Painter for a property to give it the opportunity of formatting the property value for display. If a string is returned, the Painter uses it. If a string is not returned, the Painter default formatting is used.
If you want your subclassed controls to return their textual representation of a property value, you must reimplement this method so that it can be called by Painter.
The method in the following example shows the use of the getPropertyDisplay method.
getPropertyDisplay(property: String; str: String io): Boolean;
begin
inheritMethod(property, str);
if property = "clockType" then
str := "clockType";
return true;
endif;
end;