Partilhar via


SemanticItem Property for French (Canada)

  Microsoft Speech Technologies Homepage

Gets or sets the ID of the SemanticItem control that receives the value of the chosen item. Read/write.

Usage

ASP.NET markup: <speech:DataTableNavigator SemanticItem="..." />
Get value: String = DataTableNavigator.SemanticItem;
Set value: DataTableNavigator.SemanticItem = String;
Data type: String
Required: Yes

Remarks

The value of SemanticItem is set at run time when the user selects an item in a DataTableNavigator control. Typically, the value of the property indicates the row selected by the user. If the user cancels the operation, the value of SemanticItem is set to "Exit". The value of SemanticItem persists while the page containing the DataTableNavigator control remains open on either the application client or server.

Attribute data

When the DataTableNavigator control has completed a navigation operation successfully, it places the following attributes in the SemanticItem property.

Attribute Name Data Element
spokenText The text spoken by the user
index The row index, if selected by user

Application authors can reference SemanticItem attribute data by means of the GetAttribute method of the client-side SemanticItem object.

Example

The following example is adapted from the Speech Application SDK TableNavigation sample.

<form id="Form1" method="post" runat="server">
  ...
  <speech:DataTableNavigator id="Navigator1" runat="server" 
    DataSource="<%# dataSet11 %>"
    DataMember="CityInfo" 
    InitialTimeout="3000" 
    ShortInitialTimeout="500"
    MaxTimeout="30000" 
    DataContentFields="maximum,minimum,conditions"     
    QuestionPrompt="prochaine commande?" 
    PromptSelectFunction="promptSelectFunction" 
    DataHeaderFields="City"     
    SemanticItem="siDataTableNavigator">
    <CommandRules>
      <speech:CommandRule Type="First"></speech:CommandRule>
      <speech:CommandRule Type="Last"></speech:CommandRule>
      <speech:CommandRule Type="Exit"></speech:CommandRule>
      <speech:CommandRule Type="Next"></speech:CommandRule>
      <speech:CommandRule Type="Previous"></speech:CommandRule>
      <speech:CommandRule Type="Select" Active="False"></speech:CommandRule>
      <speech:CommandRule Type="Header" Active="False"></speech:CommandRule>
      <speech:CommandRule Type="Read"></speech:CommandRule>
    </CommandRules>
  </speech:DataTableNavigator>
  ...
</form>

See Also

DataTableNavigator Class | DataTableNavigator Constructor | DataTableNavigator Members | DataTableNavigator Properties | DataTableNavigator Methods | DataTableNavigator Events | DataTableNavigator Remarks | DataTableNavigator Client Object