4.4.37 Set Command Properties dialog box
The Set Command Properties dialog box appears when you choose Tools, Set Command Properties. In this dialog box, you can define the command properties that apply when a user clicks a button control or function key control, or enters data in the edit control.
![[Figure]](GRAPHICS/ZU040437.GIF)
- Organization of this subsection
(1) Components
In the Set Command Properties dialog box, you can set the following items for a command.
- Command number
-
Specify the number of the command.
- Action when button is pushed
-
- Execution contents and Menu form status
-
From the drop-down list, select the action at command execution and the status after the command is executed.
The default settings are Execute an external command and Close the menu form, respectively.
See (3) below for further details on defining the command action.
- Execution file pathname
-
Specify the file path for execution. You can specify character strings or a variable name that stores character strings. If the character string you specified or the character string stored in the variable is an invalid file path, an error occurs.
You can specify a file path only if you set Execute an external command in Execution contents.
You cannot specify an array variable for a variable name.
- Variable name
-
Select this check box if you want to specify a variable name in Execution file pathname.
- Browse
-
Click to specify a file path in the Open File dialog box.
- Parameter
-
Specify a parameter to pass to the executable command. You can specify character strings or a variable name that stores character strings.
If you specify any of the character strings listed below as a parameter, the setting is treated as the default window display setting for the application to be started. This parameter is not applicable to applications that display windows explicitly.
You cannot specify an array variable for a variable name.
Parameter
Meaning
"/SPT:HIDE"
Hides the application window.
"/SPT:MIN"
Minimizes the application window to an icon.
"/SPT:MAX"
Maximizes the application window.
You can specify a parameter only if you set Execute an external command in Processing executed.
- Variable name
-
Select this check box if you want to specify a variable name in Parameter.
Note that you can specify only one variable. To pass multiple parameters as variables, you must set the multiple values in a single variable by using the space as a delimiter between the values.
- Execution folder
-
Specify the execution folder for the command. You can specify character strings or a variable name that stores character strings.
You can specify an execution folder only if you set Execute an external command in Processing executed. If you do not specify a folder, the current folder is assumed internally.
You cannot specify an array variable for a variable name.
- Variable name
-
Select this check box if you want to specify a variable name in Execution folder.
- Browse
-
Click to specify an execution folder in the Select Folder dialog box.
- Execution menu form name
-
Specify the name of the menu form to be activated.
You can specify a menu form name only if you set Display a menu form in the file in Execution contents.
- Execution subroutine name
-
Specify the name of the subroutine to be executed.
You can specify a subroutine name only if you set Call a subroutine in the file in Execution contents.
(2) Operations
-
Click OK to apply the settings and close the Set Command Properties dialog box.
-
Click Cancel to close the dialog box without changing the command properties.
(3) Button actions
The following tables show the possible combinations of Execution contents and Menu form status settings in the Action when button is pushed field, and the system processing for each combination.
(a) Execution contents = Execute an external command
|
Menu form status |
Specifiable |
System processing |
|---|---|---|
|
Close the menu form. |
Yes |
Executes the external command and closes the menu form without waiting for the command to complete. |
|
Cancel and return to the previous menu form. |
No |
-- |
|
Go back to the previous menu form. |
Yes |
Executes the external command and returns to the previous menu form without waiting for the command to complete. |
|
Wait for termination with the information displayed. |
Yes |
Executes the external command and leaves the menu form in disabled state until the action completes. |
|
Wait for termination with the information hidden. |
Yes |
Executes the external command and hides the menu form until the action completes. |
|
Wait with the window minimized. |
Yes |
Executes the external command and minimizes the menu form until the action completes. |
|
Place it in idle status. |
Yes |
Simply executes an external command but does not wait for completion. |
- Legend:
-
Yes: Combination that can be specified.
No: Combination that cannot be specified.
--: Not applicable
(b) Execution contents = Display a menu form in the file
|
Menu form status |
Specifiable |
System processing |
|---|---|---|
|
Close the menu form. |
No |
-- |
|
Cancel and return to the previous menu form. |
No |
-- |
|
Go back to the previous menu form. |
No |
-- |
|
Wait for termination with the information displayed. |
Yes |
Displays the specified menu form and leaves the active menu form in disabled state until the action completes. |
|
Wait for termination with the information hidden. |
Yes |
Displays the specified menu form and hides the active menu form until the action completes. |
|
Wait with the window minimized. |
No |
-- |
|
Place it in idle status. |
No |
-- |
- Legend:
-
Yes: Combination that can be specified.
No: Combination that cannot be specified.
--: Not applicable
(c) Execution contents = Call a subroutine in the file
|
Menu form status |
Specifiable |
System processing |
|---|---|---|
|
Close the menu form. |
Yes |
Calls the specified subroutine and leaves the menu form in disabled state until the action completes. If the subroutine is a Function statement, ends the menu form if the return value is True, otherwise, does nothing. |
|
Cancel and return to the previous menu form. |
No |
-- |
|
Go back to the previous menu form. |
Yes |
Calls the specified subroutine and leaves the menu form in disabled state until the action completes. If the subroutine is a Function statement, returns to the previous menu form if the return value is True, otherwise, does nothing. |
|
Wait for termination with the information displayed. |
Yes |
Calls the specified subroutine and leaves the menu form in disabled state until the action completes. |
|
Wait for termination with the information hidden. |
Yes |
Calls the specified subroutine and hides the menu form until the action completes. |
|
Wait with the window minimized. |
No |
-- |
|
Place it in idle status. |
No |
-- |
- Legend:
-
Yes: Combination that can be specified.
No: Combination that cannot be specified.
--: Not applicable
(d) Execution contents = Switch function keys
|
Menu form status |
Specifiable |
System processing |
|---|---|---|
|
Close the menu form. |
No |
-- |
|
Cancel and return to the previous menu form. |
No |
-- |
|
Go back to the previous menu form. |
No |
-- |
|
Wait for termination with the information displayed. |
No |
-- |
|
Wait for termination with the information hidden. |
No |
-- |
|
Wait with the window minimized. |
No |
-- |
|
Place it in idle status. |
No |
-- |
- Legend:
-
Yes: Combination that can be specified.
No: Combination that cannot be specified.
--: Not applicable
(e) Execution contents = Do nothing
|
Menu form status |
Specifiable |
System processing |
|---|---|---|
|
Close the menu form. |
Yes |
Closes the menu form. |
|
Cancel and return to the previous menu form. |
Yes |
Returns to the previous menu form without checking the entered data or assigning values to variables. |
|
Go back to the previous menu form. |
Yes |
Returns to the previous menu form. |
|
Wait for termination with the information displayed. |
No |
-- |
|
Wait for termination with the information hidden. |
No |
-- |
|
Wait with the window minimized. |
Yes |
Minimizes the menu form. |
|
Place it in idle status. |
Yes |
Does nothing. |
- Legend:
-
Yes: Combination that can be specified.
No: Combination that cannot be specified.
--: Not applicable
(4) Processing
-
When you set Execute an external command in Execution contents, the following values are stored as reserved variables.
Menu form status
Reserved variable
Stored value
Place it in idle status.
_EXEC_RTN_
None
_EXEC_ID_
Identifier of the executable file
All other values
_EXEC_RTN_
Exit code of external command
-
A message box appears if the external command executed from the Menu command returns a non-zero exit code. If you do not want to display a message box, set 0 as the value of the registry shown below.
- Registry key
-
HKEY_LOCAL_MACHINE\Software\Hitachi\JP1/Script\SPTX
- Value name
-
Menu_EmgMsgBox
- Value data type
-
DWORD
- Values
-
0: Do not display a message box.
1: Display a message box.
- When the setting takes effect
-
The setting takes effect the next time the script file is executed.