Actions
 Shorthand commands
 Meta actions
 BRINGUP details
 Unicode characters
 Actions configuration file
 Action classes for applications
Numbers and Spoken Forms
Unimacro and Vocola
Tracing
Inifiles
Translations
Cooperation with voicecoder
AutoHotkey
Unit testing
Grammar classes
Global dictation
Monitorfunctions

Actions.ini, the actions configuration file

This file holds configurable parameters that can be used in different other grammars. They are speech profile (user language) independent, that the parameters can vary with different Windows systems, especially with other language systems (like Dutch).

Meta actions

Most sections of the actions.ini file are devoted to the so-called meta actions.

For all sorts of meta actions there is a default section ([default]), but each meta action can be overruled for a program by making specific secions like [excel] or [firefox].

See also: examples of meta actions.

If the action is empty, it will be skipped. For example a fairly obscure meta action afterlines is normally empty:

[default]
afterlines =

For emacs there is a very special treatment (which does something with toggling line numbers):

[emacs]
afterlines = {alt+x}setnu-mode{enter}; {alt+x}setnu-mode{enter}

The other way round (set in the [default] section, but empty in some program section) is also possible.

Changing child and top behaviour

For some grammars and commands you need to know if a window is a top window (normally has a button on the taskbar) or a child window (like a open or file save as dialog window).

In some cases the standard return of the function isTopWindow doesn't match what you want:

  • The Dragon bar itself should be treated as top window, but is reported as child window, this can be confusing especially in the _folders grammar;
  • In Komodo popup windows like Find and Yes/No windows (with title Komodo) are reported as top windows, but should behave as a child window. This should be configured for the killWindow function or the (KW Unimacro shorthand command).

In the section [general] of the actions.ini file these two types of behavior can be specified, see example:

[general]
child behaves like top = natspeak: dragon-balk, dragonbar
top behaves like child = komodo: find, komodo

Note that unlike other window title comparisons, here the whole title must match one of the words specified by a comma (and all titles are converted to lowercase).

(For NatSpeak, the Dragon bar, we have a language dependency, because the window title changes with another language speech profile.)

Bringup sections

For the different bringup commands, mainly used in the grammar _taks, several sections are used for specifying how a program should be called. Please see the separate section on this.

Example Messages from NatLink window

In order to close the messages window, you can simply say now task messages close (ie the messages window is brought in front and closed)

In order to refresh the messages window you can insert in the file actions.ini the following section:

[natspeak messages]
taskrefresh = <<windowclose>>; PRINT new messages window