Please enable JavaScript to view this site.

R:BASE 11 Help

Navigation: Command Index > P

PROPERTY

Scroll Prev Top Next More

Use the PROPERTY command to dynamically change the properties of form control object(s), the form itself, form tables, the R:BASE application, themes, and more.

 

PROPERTY

 

Options

 

APPLICATION ApplicationProperty

Specifies to alter an application property such as the CAPS lock status, if it is compiled, or the title

 

BLOB_EDITOR BlobEditorProperty

Specifies to alter the display of the BLOB Editor utility

 

CLIPBOARD ClipBoardProperty

Specifies to utilize the Windows clipboard

 

Component ID

Specifies the unique identifier assigned to a control (e.g. DB Edit). The Component ID within the PROPERTY command must match the unique identifier listed in the control properties. The "Component ID" field is located in the Object Properties for all forms, reports, labels, and controls. A "Component ID" option is also located in the speed menu list when you right click on a report/label control. Wildcards are supported for altering the properties of multiple components.

 

When using multiple forms, the Component ID portion of the PROPERTY command can consist two parts, the Component ID of the form, and the Component ID on a control on the form.

 

PROPERTY 'FormComponentID|ControlComponentID' Component_Property value

 

Example (Used to switch focus with MDI forms):

 

PROPERTY 'MDI_Customers|EGB_Next' SET_FOCUS 'TRUE'

 

ControlProperty

Specifies the name of the form/report/label object's property you wish to change

 

LOADWINDOW WindowProperty

To alter the load window property such as the caption or title. The LOADWINDOW parameter is only supported in R:Compiler.

 

Parameters

The optional value(s) you can pass onto the calling command, if required. Use a blank space ' ' with single or double quotes (depending on your database QUOTE settings), if parameter is not required in calling command block.

 

RBA_FORM ApplicationFormProperty

Specifies to alter an application form property such as the current theme, the enabled status for an action, or a caption

 

RBASE_FORM FormProperty

Specifies to alter a form property such as height, width, background, etc.

 

RBASE_FORM_ACTION CustomFormActionName

Specifies the actual name of the Command Name assigned when designing Custom Form Actions in the Form Designer

 

REPORT ReportProperty

Specifies to alter a report property such as the report name, the total page count, or the number of tables using in the report

 

ROSK RBASEOnScreenKeyboardProperty

Specifies to alter the display of the R:BASE On-Screen Keyboard (ROSK)

 

SPEECH SpeechProperty

Specifies to utilize the speech functionality for specified text

 

TABLE FormTableName

Specifies the driving table name of the form

 

TABLE_COLUMN ColumnProperty

Specifies the table's column value to alter

 

ThemeName

Specifies the external theme name to load, release, or change. For more information on using the PROPERTY command to manage external themes, see External Themes.

 

ThemeProperty

Specifies the theme property to manage

 

Value

Specifies the new value to assign to the property of the object specified

 

Tips:

 

Properties of any control can be changed with assigned Component ID only.

To change any property of a form control after the form is displayed, use the PROPERTY command(s) within the "On After Start EEP" section of the Form Properties.

Always use the current QUOTES character around the Value parameter, if the value is text.

 

Notes:

 

The complete list of PROPERTY command parameters are available within the FormProperties.pdf and FormProperties_TOC.pdf PDF documents, which are provided within the R:BASE program directory and are also available for download at the R:BASE Technologies Support page: http://www.rbase.com/support/

An optional syntax builder add-on product called R:Docs, containing all PROPERTY/GETPROPERTY commands and parameters constructed in an R:BASE application, is also available. Please contact the R:BASE Technologies Sales Staff at sales@rbase.com if you wish to acquire an annual subscription to the stand-alone R:Docs application.

 

Examples:

 

Example 01.

To change the color of any control with Component ID:

PROPERTY ComponentID COLOR 'RED'

 

Example 02.

To hide the control:

PROPERTY ComponentID VISIBLE 'FALSE'

 

Example 03.

To change the font color:

PROPERTY ComponentID FONT_COLOR 'GREEN'

 

Example 04.

To change the font size:

PROPERTY ComponentID FONT_SIZE 36

 

Example 05.

To change the text alignment:

PROPERTY ComponentID ALIGN 'CENTER'

 

Example 06.

To change the form width:

PROPERTY RBASE_FORM WIDTH 300

 

Example 07.

To change the form height:

PROPERTY RBASE_FORM HEIGHT 300

 

Example 08.

To activate form Auto Scroll option:

PROPERTY RBASE_FORM AUTOSCROLL 'TRUE'

 

Example 09.

To change form color to teal:

PROPERTY RBASE_FORM COLOR 'TEAL'

 

Example 10.

To change form caption:

PROPERTY RBASE_FORM CAPTION 'New Form Caption'

 

Example 11.

To change form hint:

PROPERTY RBASE_FORM HINT 'New Form Hint'

 

Example 12.

To refresh table:

PROPERTY TABLE tablename 'REFRESH'

 

Example 13.

To move to the last record in the selected data set.

PROPERTY TABLE tablename 'LAST'

 

Example 14.

To move to the first record in the selected data set. Notice the quotes around the TEXT value while value with number without the quotes.

PROPERTY TABLE tablename 'FIRST'