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.
Displaying the application timer procedure editor
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 .
Application Timer Procedures Editor
The display area lists the Timer Proc Name, Interval, Parameter Type, and Parameter of each timer procedure that has been added to the application.
Selecting, adding, and deleting a timer procedure
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.
Parameter
type values
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.
Declaring additional user-defined types
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.
Matching parameters from the application timer
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.
Parameter values
The Parameter field accepts the following values as the client data value to pass to the callback procedure:
Note: String values must be double-quoted.
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.
Note: Although Builder Xcessory allows you to define a series of work procedures, the X Toolkit Intrinsics execute only the most recently added procedure until that procedure is removed from the set of work procedures. Refer to your Xt documentation for more detailed information on how work procedures operate and how to write work procedures effectively.