SemanticValue.Item[String] Proprietà

public:
 property System::Speech::Recognition::SemanticValue ^ default[System::String ^] { System::Speech::Recognition::SemanticValue ^ get(System::String ^ key); void set(System::String ^ key, System::Speech::Recognition::SemanticValue ^ value); };

public System.Speech.Recognition.SemanticValue this[string key] { get; set; }

member this.Item(string) : System.Speech.Recognition.SemanticValue with get, set

Default Public Property Item(key As String) As SemanticValue

Parametri

Valore della proprietà

Restituisce un elemento figlio dell'oggetto corrente SemanticValue che può essere indicizzato come parte di una coppia chiave-valore: KeyValuePair<String,SemanticValue>.

Implementazioni

Eccezioni

Esempio

L'esempio seguente mostra un gestore per un SpeechRecognized evento progettato per gestire i comandi per modificare il colore di primo piano e di sfondo.

Dopo aver gestito le frasi riconosciute che non hanno una struttura semantica, il gestore verifica la presenza di chiavi appropriate usando ContainsKey (applyChgToBackground, colorRGBValueListo , e colorStringList)quindi usa la Item[] proprietà per ottenere i nodi con le informazioni necessarie).

L'uso di Item[] è evidenziato di seguito.

newGrammar.SpeechRecognized +=
  delegate(object sender, SpeechRecognizedEventArgs eventArgs)
  {

    // Retrieve the value of the semantic property.
    bool changeBackGround = true;
    string errorString = "";
    SemanticValue semantics = eventArgs.Result.Semantics;

    Color newColor = Color.Empty;

    try
    {
      if (semantics.Count == 0 && semantics.Value==null)
      {
        // Signifies recognition by a grammar with no semantics.
        // Parse the string, assuming that the last word is color,
        //  searching for background or foreground in input.
        if (eventArgs.Result.Text.Contains("foreground"))
        {
          changeBackGround = false;
        }
        string cName = eventArgs.Result.Words[eventArgs.Result.Words.Count - 1].Text;
        newColor = Color.FromName(cName);

      }
      else if (semantics.ContainsKey("colorStringList") ^ semantics.ContainsKey("colorRGBValueList"))
      {

        // Determine whether to change background or foreground.
        if (semantics.ContainsKey("applyChgToBackground"))
        {
          changeBackGround = semantics["applyChgToBackground"].Value is bool;
        }

        // Get the RGB color value.
        if (semantics.ContainsKey("colorStringList"))
        {
          newColor = Color.FromName((string)semantics["colorStringList"].Value);
        }
        if (semantics.ContainsKey("colorRGBValueList"))
        {
          newColor = System.Drawing.Color.FromArgb((int)semantics["colorRGBValueList"].Value);
        }
      }
      else
      {

        // Throw an exception if the semantics do not contain the keys we
        // support.
        throw(new Exception("Unsupported semantic keys found."));
      }
    }

    catch (Exception exp)
    {
      MessageBox.Show(String.Format("Unable to process color semantics.:\n{0}\n", exp.Message));
      return;
    }

    // Change colors, either foreground or background.
    if (changeBackGround)
    {
      BackColor = newColor;
      float Bright = BackColor.GetBrightness();
      float Hue = BackColor.GetHue();
      float Sat = BackColor.GetSaturation();
      // Make sure that text is readable regardless of background.
      if (BackColor.GetBrightness() <= .50)
      {
        ForeColor = Color.White;
      }
      else
      {
        ForeColor = Color.Black;
      }
    }
    else
    {
      ForeColor = newColor;
      float Bright = ForeColor.GetBrightness();
      float Hue = ForeColor.GetHue();
      float Sat = ForeColor.GetSaturation();

      // Make sure that text is readable regardless of the foreground.
      if (ForeColor.GetBrightness() <= .50)
      {
        BackColor = Color.White;
      }
      else
      {
        BackColor = Color.Black;
      }
    }
    return;
  };

Commenti

è Item[] di sola lettura e genera eccezioni se i membri vengono modificati.

È possibile accedere ai dati solo in base al valore della chiave in fase di esecuzione, non in fase di compilazione, ad esempio per controllare semantic["myKey"].Value. Se si specifica una chiave non presente, viene generata un'eccezione.

Per rilevare la presenza di una determinata chiave, usare la ContainsKey proprietà in un'istanza SemanticValue di .