Define the set of speech-enabled text controls (.NET)

Dynamically changing text controls on the GUI

If you dynamically change the set of controls on the GUI (for example, your app adds/removes or enables/disables specific text fields depending on the user’s actions), you must synchronize the VUI to recognize these changes.

Procedure

1. Add/remove all controls on the GUI.
2. Call Synchronize() on the GUI form's VuiController.

Excluding text controls from speech recognition

If a GUI form in your app displays text controls that you want to exclude from speech recognition, do the following:

1. For a text control call EnableControl(object control, bool enable) on the VuiController and set the enable parameter to false.

You can either call this method before you call Open() on the VuiController or, if the VuiController was already initialized, call Synchronize() afterwards to apply the changes.

The text control is excluded from speech recognition; this means that users of your app can't record into this text control and the GUI control can't be reached via voice navigation.

Speech-enabling read-only/password text controls

Prerequisites

• You've created and speech-enabled a GUI form.

• You've set text controls to be read-only or added password fields; these aren't speech-enabled by default.

Procedure

If a GUI form in your app displays text controls that are read-only or password fields, and you want to speech-enable those GUI text controls, do the following:

1. Call EnableControl(object control, bool enable) and set the parameter enable to true on the VuiController.

You can either call this method before you call Open() on the VuiController or, if the VuiController was already initialized, call Synchronize() afterwards to apply the changes.

The text control is now speech-enabled. This means that users of your app can record into this text control and the GUI control can be reached via voice navigation.