Specifying Default Speech Control Properties

Use SpeechControlSettings controls to specify default properties in SpeechControlSettingsItems for QA, Command, Speech CustomValidator (CustomValidator), Speech CompareValidator (CompareValidator), and SemanticItem controls on the current .aspx page.

To specify a collection of default properties

1. In the Speech Toolbox, drag a SpeechControlSettings control onto the design canvas.
2. Right-click the control, and on the shortcut menu, click Property Builder to open the General panel of the SpeechControlSettings Property Builder.
3. In the ID text box, type a unique ID for this SpeechControlSettings control.
4. At the bottom left corner of Property Builder, click Add to create a new folder item in the tree view pane labeled SpeechControlSettingsItem1.
5. In the tree view pane on the left, click the name of the Speech Control to set properties for, and then specify the new default properties for that SpeechControlSettingsItem.

Each labeled folder item in the tree view pane under the SpeechControlSettings heading represents a collection of default settings that developers can apply to other Speech Controls on that page.

Create more collections of settings by adding more folder items to the tree, and specifying different default property values.

To add a new collection of properties

• In the SpeechControlSettings Property Builder, click Add to create a new folder item in the tree view pane labeled SpeechControlSettingsItemn, where n is the next number in the list.

Use SpeechControlSettingsItem Collection Editor as an alternative to SpeechControlSettings Property Builder.

For example, consider that a Command control with an ID of "HelpCommand" should reference the properties and settings defined in an existing SpeechControlSettingsItem with an ID of "HelpCommandSettings." Use the following procedure to create the reference.

1. On the Speech Toolbox, drag a SpeechControlSettings control onto the design canvas.
2. Right-click the SpeechControlSettings control, and on the shortcut menu, click Properties.
3. On the Properties window, on the Items row, click the ellipses (...) button to open SpeechControlSettingsItem Collection Editor.
4. On the Members pane, click the SpeechControlSettingsItem with the ID of "HelpCommandSettings."
5. On the SpeechControlSettingsItem Properties pane, expand the Command control, populate any relevant properties, and then click OK to close SpeechControlSettingsItem Collection Editor.
6. On Speech Control Editor, right-click the Command control with the ID of "HelpCommand," and then on the shortcut menu, click Property Builder.
7. On the Speech Control Settings box, select the SpeechControlSettingsItem with the ID of "HelpCommandSettings."

The "HelpCommand" Command control now references all properties defined in the "HelpCommandSettings" SpeechControlSettingsItem.

To remove a collection of properties

• In the SpeechControlSettings Property Builder, in the tree view pane on the left, click the name of the SpeechControlSettingsItem to remove, and then click Remove.

To apply a collection of settings to a new Speech Control

1. Right-click a QA or Command control on an .aspx page, and on the shortcut menu, click Property Builder to open the General panel of that control's Property Builder.
2. In the Speech Control Settings box, type or select the ID of the SpeechControlSettingsItem to apply to this control.
3. Click Apply to save changes, and then click OK to close Property Builder.

See Also

Creating Speech-Enabled Web Pages | Designing Dialogue Flow | Dialogue Organization