How to: Specify Default Speech Control Properties

Article
08/18/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

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.

Specifying a Collection of Default Properties

To specify a collection of default properties

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

Each labeled folder item under the SpeechControlSettings control 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.

Adding a New Collection of Properties

To add a new collection of properties

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

Use SpeechControlSettingsItem Collection Editor as an alternative to the 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.

Creating a Reference

To create the reference

In the Toolbox, drag a SpeechControlSettings control onto the design canvas.
Right-click the SpeechControlSettings control, and then click Properties.
In the Properties window, click the browse (...) button on the Items row to open SpeechControlSettingsItem Collection Editor.
In the Members pane, click the SpeechControlSettingsItem control with the ID of HelpCommandSettings.
In the SpeechControlSettingsItem Properties pane, expand Command, populate any relevant properties, and then click OK.
In Speech Control Editor, right-click the Command control with the ID of HelpCommand, and then click Property Builder.
In the Speech Control Settings box, select the SpeechControlSettingsItem control with the ID of HelpCommandSettings.

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

Removing a Collection of Properties

To remove a collection of properties

In the SpeechControlSettings Property Builder, click the name of the SpeechControlSettingsItem control to remove, and then click Remove.

Applying Settings to a New Speech Control

To apply a collection of settings to a new Speech Control

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

Share via