Special properties

Special properties can be set or retrieved with the standard methods, setProperty and getProperty, of the java-bean object.

setProperty has two parameters: propertyName and propertyValue.

getProperty has only one parameter (propertyName) and returns propertyValue.

Property definitions are stored in the definition files created by the cpgen utility. Property definitions are comment entries with the following structure:

*> NAME: propertyName , TYPE: parameterType (classReference) readWriteFlag

propertyName is the name of the property. It must be passed, enclosed in single or double quotes, as the first parameter of the setProperty and getProperty methods. propertyName is not case-sensitive.

parameterType represents the type of the item passed as the second parameters of the setProperty method or returned by the getProperty method.

readWriteFlag allows the user to know if the property can be set, retrieved or both. Possible values are:

R	Property can be retrieved with the getProperty method.
W	Property can be set with the setProperty method.
R/W	Property can be retrieved with the getProperty method and set with the setProperty method.

The reference to the java-bean can be defined in the screen section, in the DISPLAY statement or retrieved with the INQUIRE statement.

Example:

03 myDateField     java-bean    clsid           "com.toedter.calendar.JDateChooser"    line            2    col             2    size            30    lines           1.5    object in       objDateField

display java-bean    clsid           "com.toedter.calendar.JDateChooser"    line            2    col             2    size            30    lines           1.5    handle in       myDateField    object in       objDateField

inquire myDateField, object in objDateField

The object reference can then be used to set or retrieve special properties.

Example:

objDateField:>setProperty("weekOfYearVisible" 0)

SET myVariable TO objDateField:>getProperty("weekOfYearVisible")