Application Work Procedure Editor

Allows you to add work procedures to your application. This allows you to specify a function to call when there are no other X events pending.

Displaying the application manager

Click the (...) button to the right of the Work Procedure input field on the Application Manager to display Application Work Procedure Editor. Refer to Application Manager .

Application Work Procedures Editor

The display area lists the Work Procedure name, Parameter Type, and Parameter of each work procedure that has been added to the application.

Selecting, adding, and deleting work procedures

Select, add, and delete work procedures using the following methods:

· Select a work procedure by clicking on its name in the list. All appropriate fields are updated for the selected work procedure.

· Add a work procedure to the list by clicking New and entering the Work Procedure name and any necessary parameter data in the appropriate text fields.

· Delete a work procedure by selecting it in the list and clicking the Delete button.

Declaring additional user-defined types

You can declare additional user-defined types in the Application Work Procedure Editor by entering the new type name in the Parameter Type field.


Note: 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 Work Procedure Editor, indicating that parameter values of any type are accepted in the Parameter field. Other valid values include:

· Pre-defined types

· User-defined types

· None

None indicates that the work procedure takes no value as its client data. Click on the arrow to the right of the Parameter Type label in the Application Work Procedure Editor for a list of available value.

The Parameter Type field is grayed out if the work procedure specified in the Work Procedure field is referenced by a widget or style resource in your interface. The procedure's parameter type cannot be changed in the Application Work Procedure Editor, unless you remove all references to the procedure from the interface.

Matching parameters in application work procedure editor

When Builder Xcessory encounters a parameter in the Application Work Procedure Editor, it searches for a match in the following order:

· Identifier

· Constant

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:

· Constants

· Identifiers

· Boolean

· Integer

· Floating point

· String values


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.

 

Documentation: