UIML Interface Components (UIML 1.0)

HCmdLineExecute

Toolkit:

com.harmonia.hwt

Description:

A special component that allows calling external programs from a command line. To use this, include an HCmdLineExecute in the frame from which the call will be made. Invoke it by using the ACTION tag to set its RUN attribute. Other attributes allow more control over how the external program is run; see the descriptions of these attributes for more information.

COMMAND

Allowed Values	Meaning
A string	A command to be executed. This attribute specifies the program to run; use COMMAND_ARGUMENTS to pass arguments to the program.

COMMAND_ARGUMENTS

Allowed Values	Meaning
A comma-separated string	A list of arguments to pass to a command, separated by commas. Any occurrence of $CONTENT in this string is replaced with the value of the CONTENT attribute before passing it to the command associated with the HCmdExecute component.

CONTENT

Allowed Values	Meaning
A string.	In HCmdLineExecute: specifies a string to use in place of $CONTENT in the arguments string specified in COMMAND_ARGUMENTS.

DELAY

Allowed Values	Meaning
Non-negative integer	Wait this many seconds before executing. (Zero means execute immediately.)
-1	Causes the HCmdExecute component to wait until it receives an event before executing the command.

ENVIRONMENT

Allowed Values	Meaning
A string, in operating system's format for setting environment variables.	Specifies environment variables to set before executing a command.

REPEAT

Allowed Values	Meaning
A non-negative integer	Specifies the number of times to repeat the command. Default is 1; zero means don't execute the command.
-1	Repeat indefinitely. The HCmdExecute component repeatedly executes the command until its RUN attribute is set to false.