Timer control

Use this control to add a clock timer to the form. The timer initiates events at a certain time, based on settings in the Input and Expiration Event fields.

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

To place a clock timer on a form, click Timer and then click the form.
Be sure to put the name of the database field or variable that you want to associate with this control into the Input property.

Property	Usage
Name	Specify a unique identifier for the object on the screen. (Optional) This name is used by external applications, such as RAD, to dynamically change the properties of the object.
X	Specify the object’s horizontal position based on the left edge of the object.
Y	Specify the object’s vertical position based on the top edge of the object.
Width	Specify the width of the object in alignment grid units.
Height	Specify the height of the object in alignment grid units.
Visible	Select this option to make the object visible on the form. Clear the check box to hide the object from view on the form.
Visible Condition	Specify an expression to override the Visible property when that expression evaluates to true.
Caption	Specify a text caption for the object.
Caption Condition	Specify an expression to override the Caption property when that expression evaluates to true.
Input	Specify the database field or variable to associate with this control.
Font	Select a font for the text of your label, table, timer, or marquee caption from the drop-down list.
Foreground Color	Select the text color from the drop-down list.
Foreground Color Condition	Specify a formula to evaluate the ForeColor property at run time. The result of this evaluation overrides the value assigned to the property.
Background Color	Specify the Background Color. You must select the Opaque property check box for the Back Color to have an effect. The only Background Color available for a Windows client marquee is black.
Background Color Condition	Specify an expression to override the BackColor property when that expression evaluates to true.
Bold	Select this option to apply bold to the label, default text, frame caption, or marquee caption.
Bold Condition	Specify an expression to override the Bold property when that expression evaluates to true.
Italic	Select this option to apply italics to your label, default font, or caption.
Italic Condition	Specify an expression to override the Italic property when that expression evaluates to true.
Font Increase	Specify the amount, in points, to increase or decrease the standard font size.
Font Increase Condition	Specify an expression to override the Font Increase property when that expression evaluates to true.
Output Conversion	Specify the name of an Output Conversion routine. If specified, the routine is called at runtime to convert the contents of the field before it is displayed on the screen. For examples, refer to the RAD input and output routines.
Array Length	Specify the size of the scrolling region used to view array entries. A scroll bar appears beside the fields to allow users to view the array entries. - If a field is assigned an Array Length of 5, the form stacks five fields vertically to allow users to view the five array entries. - If Array Length is set to -1, the form dynamically creates as many fields as there are entries in the array. - If the Input data type is scalar, only a single text box appears. Note: The screen object must be associated with an array data structure. The default is 0, which means one vertical line of information appears.
Expiration Color	Specify the color that the timer should change to when it reaches zero.
Expiration Event	Specify the event to send to the server when the timer reaches zero. Specify a numeric value; for example, a button or event ID.

Property

Usage

Name

Specify a unique identifier for the object on the screen. (Optional)

This name is used by external applications, such as RAD, to dynamically change the properties of the object.

Specify the object’s horizontal position based on the left edge of the object.

Specify the object’s vertical position based on the top edge of the object.

Width

Specify the width of the object in alignment grid units.

Height

Specify the height of the object in alignment grid units.

Visible

Select this option to make the object visible on the form. Clear the check box to hide the object from view on the form.

Visible Condition

Specify an expression to override the Visible property when that expression evaluates to true.

Caption

Specify a text caption for the object.

Caption Condition

Specify an expression to override the Caption property when that expression evaluates to true.

Input

Specify the database field or variable to associate with this control.

Font

Select a font for the text of your label, table, timer, or marquee caption from the drop-down list.

Foreground Color

Select the text color from the drop-down list.

Foreground Color Condition

Specify a formula to evaluate the ForeColor property at run time. The result of this evaluation overrides the value assigned to the property.

Background Color

Specify the Background Color. You must select the Opaque property check box for the Back Color to have an effect. The only Background Color available for a Windows client marquee is black.

Background Color Condition

Specify an expression to override the BackColor property when that expression evaluates to true.

Bold

Select this option to apply bold to the label, default text, frame caption, or marquee caption.

Bold Condition

Specify an expression to override the Bold property when that expression evaluates to true.

Italic

Select this option to apply italics to your label, default font, or caption.

Italic Condition

Specify an expression to override the Italic property when that expression evaluates to true.

Font Increase

Specify the amount, in points, to increase or decrease the standard font size.

Font Increase Condition

Specify an expression to override the Font Increase property when that expression evaluates to true.

Output Conversion

Specify the name of an Output Conversion routine. If specified, the routine is called at runtime to convert the contents of the field before it is displayed on the screen. For examples, refer to the RAD input and output routines.

Array Length

Specify the size of the scrolling region used to view array entries. A scroll bar appears beside the fields to allow users to view the array entries.
- If a field is assigned an Array Length of 5, the form stacks five fields vertically to allow users to view the five array entries.
- If Array Length is set to -1, the form dynamically creates as many fields as there are entries in the array.
- If the Input data type is scalar, only a single text box appears.

Note: The screen object must be associated with an array data structure.

The default is 0, which means one vertical line of information appears.

Expiration Color

Specify the color that the timer should change to when it reaches zero.

Expiration Event

Specify the event to send to the server when the timer reaches zero. Specify a numeric value; for example, a button or event ID.

Related concepts