eva/3 Application Builder • Developing eva/3 Applications • Macros • System Commands 

Utilities

Command Description Parameter
Message Opens a modal message dialog. The message dialog can be used for macros with control structures. The return value affects the control structure of the macro. A message dialog with a Yes/No option may decides about the next command which will be executed.
  • Message: The message text that will be displayed in the message dialog.
  • Title: Text that will displayed in the title bar of the message dialog.
  • Type: The type decides about displaying a symbol in the message dialog. The displayed symbol depends on the choosen application Look&Feel.
    • Plain: No symbol will be displayed in the message dialog. This is the default value.
    • Error: Displays a symbol for an error message.
    • Information: Displays a symbol for a information message.
    • Warning: Displays a symbol for a warning message.
    • Question: Displays a symbol for a question message.
  • Option: Affects the option provided to the user.
    • Default: Displays an OK button. Returns the value null.
    • Yes/No: Displays the buttons Yes and No. The return value for Yes is the same as for OK. The return value for No is the object Boolean(false).
    • Yes/No/Cancel: Displays the buttons Yes, No and Cancel. The Canceö button returns the object Boolean(false) and also aborts the execution of the macro.
    • Ok/Cancel: Displays the buttons Yes and Cancel.
  • Beep: If this property is set to true, an audio beep will be created before the message dialog opens. On Microsoft Windows, the audio beep is controlled by the system sound shema. The default value is false.
CopyCurrentRecord Copies the actual data record from the given "STableElement" into a variable in the EvaUtils class.
  • Name of the TableElement*: The name of the TableElement from which the actual record set will be copied from.
  • Use system clipboard: When setting this property to true, the record set will be copied to the clipboard, too.
PasteToCurentRecord Inserts a data record, that was copied with the command "CopyCurrentRecord", at the actual dataset position. The existing data at the recordset position will be overwritten.
  • Name of the TableElement*: The name of the TableElement in which the data will be inserted.
OpenDefaultBrowser Executes the internet browser and opens the given website. This command can also be used to start any executable file whereby the URL will used as parameter for the call of the executable file.
  • Path to Browser*: Full, absolute path to the internet browser. If this parameter is not set, the default browser will be used under Microsoft Windows and Mac OS. Under Unix or GNU/Linux a look up for known web browsers will be performed.
  • URL: The internet address that will be opened after starting the web browser.
PlaySoundFile Plays a ".mp3" or ".wav"-music file.
  • Path*: File path to the sound file to be played.
RunApplication Starts an executable file on the operating system.
  • Command line*: Complete absolute path to the executable file.
  • Parameter01: Commandline parameter given to the executable file.
  • Parameter02: Second command line parameter. See "Parameter01"
  • Parameter03: Third command line parameter. See "Parameter01"
  • Parameter04: Fourth command line parameter. See "Parameter01"
  • Parameter05: Fifth command line parameter. See "Parameter01"
  • Parameter06: Sixth command line parameter. See "Parameter01"
  • Parameter07: Seventh command line parameter. See "Parameter01"
  • Parameter08: Eighth command line parameter. See "Parameter01"
  • Parameter09: Ninth command line parameter. See "Parameter01"
  • Parameter10: Tenth command line parameter. See "Parameter01"
Beep Emits an audio beep. On Microsoft Windows, the audio beep is controlled by the system sound shema.  
SaveStaticTableDescriptor Saves the static table data
  • Path*: project related path to .table file.
StopMacro Stops the macro in which the StopMacro command is executed. This is usefull for macros with control structures.  
SetCursor Sets the mouse pointer for the given form. The mouse pointer symbol depends on the used operating system.
  • Standard: The standard mouse arrow.
    • Microsoft Windows Example:
  • Crosshair: Crosshair as mouse pointer.
    • Microsoft Windows Example:
  • Text: Mouse pointer over text input fields.
    • Microsoft Windows Example:
  • Wait: Mouse pointer in application wait state.
    • Microsoft Windows Example:
  • SW Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • SE Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • NW Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • NE Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • N Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • S Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • W Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • E Resize: Resize mouse pointer.
    • Microsoft Windows Example:
  • Hand: Mouse pointer for object selection.
    • Microsoft Windows Example:
  • Move: Mouse pointer for object moving.
    • Microsoft Windows Example:
Quit Terminates an eva/3 application by closing all available frames.
  • Save*: If data has changed, one of the following actions should be performed before termination.
    • Ask: The user will be prompted for saving or discarding the data for each STableElement which has changes.
    • Save: Saves all data without prompting the user.
    • Exit: The application will be terminated without saving any data. All changes will be automatically discarded.
SendMail Sends an e-mail using the SMTP or SMTP-AUTH protocol.

If the user name and password are specified, the SMTP-AUTH protocol will be automatically used.
  • SMTP server*: Der SMTP-Server über den die E-Mail ausgelifert wird.
  • From*: E-mail adress of the sender. (will be also used as return adress)
  • To*: E-mail adress of the receiver.
  • Realname: Realname of the sender.
  • Subject: Subject of the e-mail.
  • Message: Message text of the e-mail
  • User name: The user name to be used for the SMTP-AUTH protocol.
  • Password: The user password to be used for the SMTP-AUTH protocol.
  • Attachment: A full qualified path to the file to be attached to the e-mail.
SendKeys Sends keystrokes to the active window. The command triggers a KeyPress and KeyRelease for each specified key.

Non displayable or action keys can be described using the following codes (including the curly braces):
Key Code
BACKSPACE {BACKSPACE}, {BS} oder {BKSP}
BREAK {BREAK}
CAPSLOCK {CAPSLOCK}
DELETE {DELETE} oder {DEL}
DOWN {DOWN}
END {END}
ENTER {ENTER}oder ~
ESCAPE {ESC}
HELP {HELP}
POS 1 {HOME}
INSERT {INSERT} oder {INS}
LEFT {LEFT}
UP {UP}
NUMLOCK {NUMLOCK}
PAGE DOWN {PGDN}
PAGE UP {PGUP}
PRINT SCREEN {PRTSC}
RIGHT {RIGHT}
SCROLLL {SCROLLLOCK}
TABULATOR {TAB}
F1 - F16 {F1} - {F16}


Key modifier are specified with one of the following codes at the leading of the key:
KEY Code
SHIFT +
STRG ^
ALT %


If more than one key should be pressed with one modifier, the keys can be sourrounded with round braces. Example: +(AS) presses the keys Shift-A and Shift-S.

Is only one key to be pressed with a modifier and one without, the modifier can be specified only for the keys to be pressed with the modifier followed by the keys to be pressed without the modifier: Example: +AS pressed the keys Shift-A and S.

Key repetitions can be defined like {Key Repitition}. {ENTER 3} triggers the enter key three times, {a 10} triggers the key a ten times.

  • Keystroke*: A keystroke expressions which defines the keystrokes to be send.

With * marked parameters are mandatory declaration. All other declaration are optional. Optional fields can be empty.

System Commands System Commands