# Dialog Box

Although the dialog box annotation cannot be moved or resized, it can still be edited by selecting it and using the “Edit/Properties” option. The dialog box can be defined with the following attributes:

Library name – The name used to access the dialog box from inside the application.

Title – The text shown on the header bar of the dialog.

Modal interaction – Defines whether the dialog is “modal” or “modeless”. When a modal dialog box is displayed, the user cannot interact with any other component of the application but the contents of that dialog box. Modeless dialogs can be interacted with asynchronously.

Position with respect to screen – Specifies which corner of the screen the dialog box will be offset from. For example, if “bottom left” positioning is selected, the “X Offset” and “Y Offset” fields define the distance from the bottom left hand corner of the screen to the bottom left corner of the dialog box. This distance is specified in “screen coordinates” where the width and height of the computer screen each are 100 units.

Tab ordering of members – If you wish to use the <Tab> key to transfer input focus from one control to the next while interacting with the dialog box, the order in which this traversal takes place can be established ahead of time. A list box shows the labels of all controls in the dialog that can have input focus. The order of items in this list is the order in which input focus will proceed when the <Tab> key is pressed. Use the “Up” and “Down” buttons to shift the tab ordering of controls.

SIMSCRIPT Users:

With regard to execution control, the behavior of ACCEPT.F can be defined using the “Edit/Properties..” option on the dialog box, menu bar, or palette from within SIMDRAW. The ACCEPT.F function will behave according to one of three interaction modes. The following modes are listed:

Asynchronous: If this interaction mode is used, ACCEPT.F will suspend the active process when called. Whenever a status value of “1” is returned from the control routine or a terminating button is pushed, this process is resumed. If there is no simulation running and hence no active process, the “Synchronous” interaction mode is used.

Synchronous: Regardless of the simulation, ACCEPT.F will not return until a status value of “1” is returned from the control routine or a terminating button is pushed.

Don’t wait: ACCEPT.F won’t wait for any action by the user but will return immediately. Subsequent action on the form will invoke the control routine.

See Also

Controls

Selecting, Moving, and Resizing Controls

Cut, Copy, and Paste Applied to Controls

Coordinate System for Positioning Controls

Tabbed Dialogs