AutoItX extensions VB Script

fd.WindowAction

DEFINITION: void fd.WindowAction(string actionType, string windowTitle);

DESCRIPTION: Alllows for the manipulation of a window or dialog.

PARAMETER 1: actionType = The action to run against the desired window.

Allowable Values:

PARAMETER 2: windowTitle = String that is contained in a windows title. It is beneficial to have the closest match possible to the desired window. For example “Notepad” will select window’s titled “Untitled – Notepad” or “Notepad++”. Leaving this parameter a blank string will allow this method to act upon the current active window.

EXAMPLE CODE:

' Activate a window containing the word “notepad”
fd.WindowAction("Activate", "Notepad")
' wait 1500 milliseconds to make sure text area has focus
fd.Wait(1.5)
fd.KeyPress("H, E, L, L, O")
' close the currently selected window
fd.WindowAction("Close", "");

fd.InsertText

DEFINITION: void fd.InsertText(string text)

DESCRIPTION: Insert a large block of text into the currently focused text box. This differs from fd.KeyPress in the fact that it treats the entire string as one autonomous “paste” into the text area. fd.KeyPress should be used if individual keypresses might be needed to trigger some underlying action into the EHR like a lookup of a drug or to trigger a menu item.

PARAMETER 1: text = The text to insert.

EXAMPLE CODE:

' Activate a window containing the word “notepad”
fd.WindowAction("Activate", "Notepad")
' wait 1500 milliseconds to make sure text area has focus
fd.Wait(1.5)
fd.InsertText ("Hello")

fd.Wait

DEFINITION: void fd.Wait(int timeinSeconds)

DESCRIPTION: Wait for a number of seconds.

PARAMETER 1: timeinSeconds = Number of seconds to wait

Allowable Values:Whole and decimal numbers. For example, 1 second, 0.5 seconds or 2.5 seconds.

EXAMPLE CODE:

' Activate a window containing the word “notepad”
fd.WindowAction("Activate", "Notepad")
' wait 1500 milliseconds to make sure text area has focus
fd.Wait(1.5)
fd.KeyPress("H, E, L, L, O")

fd.BuiltInCommand

DEFINITION: void fd.BuiltInCommand(string commandName)

DESCRIPTION: Built-in Commands are the pre-populated speech commands that M*Modal has built into Fluency Direct. You can use a speech command defined via the commandName parameter to perform the function you need.

PARAMETER 1: commandName = a string the represents any number of commands predefined via Fluency Direct.

Allowable Values: The list of all possible commands can be found at https://docs.mmodal.com/direct/index.php/user-guide/fluency-direct-9-0/speech-commands. Only those commands not containing variable parts such as <spokenWordText>, <text> are possible.

EXAMPLE CODE:

fd.InsertText ("Hello")
fd.BuiltInCommand("uppercase previous five words")

fd.MouseAction

DEFINITION: void fd.MouseAction(string mouseAction, string coordinatesOrigin, int x, int y)

DESCRIPTION: MouseAction is used to drive an EHR UI with mouse events. MouseAction allows you to designate specific mouse clicks or movements for the current window or dialog. For example; you could create a "New Message" script using mouse clicks in Outlook that would create a new message to send.

To begin, use the Command Editor to create a “Mouse Action” and then select the “Relative To” position. This position is based on the application window (NOT the screen). The relative position is important, because with consideration, you can make your MouseAction less problematic if you can’t pre determine window size. For example, a given button on a window might always be a consistent distance from the bottom right corner of the screen but a variable distance from the top left depending upon window size. You can typically change a window to a number of different sizes to best learn the best relative positioning.

Next, you will select your X and Y coordinates by clicking on the “Change” link. When you click Change, a blue dot will appear in the relative position over the application that you are in. Hover your mouse over the application window that you wish to perform the mouse click in and it will become highlighted in blue. Press the Spacebar to confirm the area and the X and Y coordinates will now change to numbers other than zero. Record these coordinates for your X and Y.

PARAMETER 1: mouseAction = The type of action desired.

Allowable Values:

PARAMETER 2: coordinatesOrigin = The relative positioning of the desired X, Y to the edge of the window. The relative position is important, because with consideration, you can make your MouseAction less problematic if you can’t pre determine window size. For example, a given button on a window might always be a consistent distance from the bottom right corner of the screen but a variable distance from the top left depending upon window size.

Allowable Values:

EXAMPLE CODE: fd.MouseAction("LeftClick", "TopLeft", 582, 300)

fd.KeyPress

DEFINITION:void fd.KeyPress(string commaSeperatedkeyCombination)

DESCRIPTION:Used to simulate keystrokes into an textbox. This differs from fd.InsertText in the fact that it simulates the user typing each keystroke one at a time, whereas InsertText treats the entire string as one autonomous “paste” into the text area. Individual keypresses might be needed to trigger some underlying action into the EHR like a lookup of a drug or to trigger a menu item.

PARAMETER 1:commaSeperatedkeyCombination – a comma separated list f keystrokes. Use the command Key action step to determine the valid string to use for any given keystroke.

Sample of Allowable values:

EXAMPLE CODE: fd.KeyPress("Shift + H, E, L, L, O");

fd.GetActiveWindowTitle

DEFINITION: string fd.GetActiveWindowTitle()

DESCRIPTION: Gets the window Title of the current dialog or window.

EXAMPLE CODE (Javascript): fd.InsertText ( fd.GetActiveWindowTitle())