[Next] [Previous] [Up] [Top] [Contents] [Index]

Chapter 13. Graphic Environment Resources

13.5 Actions

Actions need an `actn' resource, which provides an icon for the "Conditions/Actions" dialog, and describes the parameter list of the action for the Action dialog.

An `actn' resource should contain the following data. Strings are pascal strings. Some strings can be defaulted by specifying a zero-length string (""). Integers need not be word-aligned.

Prompt - This is the name of the action which the user will see. It defaults to the real name of the action.

Icon Name - There should be a small icon family (`ics#', `ics4', and/or `ics8' - only the `ics#' is required) for the action. This field specifies the name given to the icon (in the `ics#'). The name defaults to the action name.

Flags - This string is used to notify the graphic interface of special characteristics of the action. No flags were supported at the time of this writing.

Next is an integer, n, specifying the number of parameters required for the action. Then, there should be n of these sub-records, one for each parameter of the action:

Attribute Descriptor - The name of the `attr' resource which describes this parameter. The description contains such information as the DCOD which handles the parameter, the default value, etc. (See also below, about the `attr' resource.)

Prompt - The name of the attribute as seen by the user.

Additional Message - A message string which should be appended to the one specified in the `attr' description.

Default Value - A string to be used as the default value for the parameter, overriding the default specified in the `attr'.

PSYX Programmer's Manual - 24 AUG 95
[Next] [Previous] [Up] [Top] [Contents] [Index]

Generated with CERN WebMaker