Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
Topic |
Prev | Next |
Win32 User Interface Simulation
Enterprise Architect supports the simulation of dialogs and screens created with the Win32® User Interface profile, to integrate user interface design with defined system behavior. Dialogs can be programmatically referenced and invoked using Javascript commands within a behavioral model such as a StateMachine, providing a fully customizable and fully interactive execution of your behavioral model.
Button controls can be used to broadcast signals, firing a trigger when the button is clicked. Signal arguments can be filled from the dialog input fields; for example, to capture and send a username and password for evaluation.
Dialogs designed using the Win32 User Interface profile (and existing within the same Package branch as the behavioral model being executed) will be created as new windows in the background at the beginning of simulation. Various properties that can affect the appearance and behavior of each dialog and control can be customized at design time via Tagged Values provided by the Win32 User Interface profile.
To interact with a dialog via JavaScript during simulation, the 'dialog' simulation-level keyword is used, followed by a period and the name of the dialog. Properties and methods can then be accessed; for example, to show the dialog, or to set the text value of an 'Edit Control':
dialog.Login.Show=true;
dialog.Login.Username.Text="admin";
Examples
For an example behavioral model that can you can execute a simulation on, open the EAExample model and locate:
Project Models > Model Simulation > StateMachine Models > Customer Login > Customer > Customer Login
Common Properties
These common properties and methods are available on most supported Win32 UI Control types.
Property/Method |
Description |
---|---|
Enable |
Boolean Enables or disables user interaction. |
Move To (x,y,width,height) |
Move the window to the specified coordinates and set the window height and width. |
Show |
Boolean Show or hide the dialog. When this property is set to False, the dialog is moved off-screen. |
Text |
String Set the title of the dialog or window. |
JavaScript Functions
Function |
Description |
---|---|
BroadcastSignal (string Signal) |
Sends a signal to the simulation event queue. Parameters:
|
UIBroadcastSignal (string Signal, array Parameters) |
Sends a signal with additional parameters to the simulation event queue. Parameters:
Example: UIBroadcastSignal("Login",{Name: dialog.Login.Username.Text, Password: dialog.Login.Password.Text}); |
ShowInterface (string InterfaceName, boolean Show) |
Deprecated. See the Show property on the 'Dialog' control. For example: dialog.HelloWorld.Show = true; |
InterfaceOperation (string InterfaceName, string ControlName, string OperationName,[string arg1],[string arg2]) |
Deprecated. Operations can be referenced directly from the control. For example: dialog.HelloWorld.ListControl.InsertItem("Test", 2); |
GetInterfaceValue (string InterfaceName, string ControlName, string OperationName,[string arg1],[string arg2]) |
Deprecated. Properties can be referenced directly from the control. For example: dialog.HelloWorld.EditControl.Text; |
Notes
Learn more