Allows you to add timer procedures to your application. Timer procedures allow you to specify the specific amount of time before this procedure is called. Use a timer procedure for an event that you want to happen periodically, but not continuously.
Click the (...) button to the right of the Timer Procedure input field on the Application Manager to display the Application Timer Procedure Editor. Refer to Application Manager .
The display area lists the Timer Proc Name, Interval, Parameter Type, and Parameter of each timer procedure that has been added to the application.
Select, add, and delete work procedures using the following methods:
· Select a timer procedure by clicking on its name in the list. All appropriate fields are updated for the selected timer procedure.
· Add a timer procedure to the list by clicking New and entering the Timer Proc Name and any necessary parameter data in the appropriate text fields.
· Delete a timer procedure by selecting it in the list and clicking the Delete button.
When changing or adding a timer procedure to the list, you can choose a procedure name from the list displayed by clicking on the arrow to the right of the Timer Proc Name label, or you can create a new procedure by typing its name in the Timer Proc Name text field. Builder Xcessory prompts you to confirm a new procedure name.
New procedures are created with a default Parameter Type of Undeclared in the Application Timer Procedure Editor, indicating that parameter values of any type are accepted in the Parameter field. Other valid values include:
· None (Indicates that the timer procedure does not take any value as its client data.)
To display a list, click on the arrow to the right of the Parameter Type label in the Application Timer Procedure Editor.
You can declare additional user-defined types in the Application Timer Procedure Editor by entering the new type name in the Parameter Type field. Builder Xcessory prompts you to confirm a new user-defined type.
The Parameter Type field is insensitive if the timer procedure specified in the Timer Proc Name field is referenced by a widget or style resource in your interface. The procedure's parameter type cannot be changed in the Application Timer Procedure Editor, unless all references to the procedure are removed from the interface.
When Builder Xcessory encounters a parameter in the Application Timer Procedure Editor, it searches for a match in the following order:
If no match is found, Builder Xcessory prompts you to declare the parameter as an identifier.
The Parameter field accepts the following values as the client data value to pass to the callback procedure:
The type of the value must correspond to the type listed in the Parameter Type field. If the text entered into the Parameter field is not a constant, identifier, or actual value, then Builder Xcessory prompts you to declare the value as an identifier of the appropriate type.