DisplayAttributes Enumeración

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Enumera las opciones que el objeto SpeechRecognitionEngine puede utilizar para especificar el espacio en blanco para la presentación de una palabra o un signo de puntuación.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

public enum class DisplayAttributes

[System.Flags]
public enum DisplayAttributes

[<System.Flags>]
type DisplayAttributes = 

Public Enum DisplayAttributes

Herencia

Object

ValueType

Enum

DisplayAttributes

Atributos

FlagsAttribute

Campos

ConsumeLeadingSpaces	16	El elemento no tiene espacios delante.
None	0	El elemento no especifica cómo se controla el espacio en blanco.
OneTrailingSpace	4	El elemento tiene un espacio después.
TwoTrailingSpaces	8	El elemento tiene dos espacios a continuación.
ZeroTrailingSpaces	2	El elemento no tiene espacios a continuación.

Ejemplos

En el ejemplo siguiente se usa la DisplayAttributes propiedad de una lista de RecognizedWordUnit objetos para dar formato a las palabras como una frase.

// Use the DisplayAttributes property to format speech as text.   

static string GetDisplayText(List<RecognizedWordUnit> words)  
{  
  StringBuilder sb = new StringBuilder();  

  // Concatenate the word units together. Use the DisplayAttributes  
  // property of each word unit to add or remove white space around  
  // the word unit.  
  foreach (RecognizedWordUnit word in words)  
  {  
    if ((word.DisplayAttributes  
      & DisplayAttributes.ConsumeLeadingSpaces) != 0))  
    {  
      sb = new StringBuilder(sb.ToString().TrimEnd());  
    }  

    sb.Append(word.Text);  

    if ((word.DisplayAttributes  
      & DisplayAttributes.OneTrailingSpace) != 0)  
    {  
      sb.Append(" ");  
    }  
    else if ((word.DisplayAttributes  
      & DisplayAttributes.TwoTrailingSpaces) != 0)  
    {  
      sb.Append("  ");  
    }  
  }  

  return sb.ToString();  
}  

Comentarios

Voz de escritorio de Windows devuelve frases reconocidas como colecciones de RecognizedWordUnit ReplacementText objetos o. Cada objeto corresponde a una sola palabra o signo de puntuación. La DisplayAttributes propiedad de un RecognizedWordUnit o ReplacementText utiliza un miembro de la DisplayAttributes enumeración para describir cómo se controla el espaciado de impresión en torno a una palabra o un signo de puntuación determinados.

Dos o más miembros de la DisplayAttributes enumeración se pueden combinar mediante un bit OR a bit para especificar cómo se debe mostrar una palabra determinada.

Nota

El formato de presentación que usa el reconocedor de voz es específico del idioma.

Por ejemplo, supongamos que la frase de entrada a un motor de reconocimiento mediante la gramática predeterminada del sistema proporcionada por DictationGrammar es "Hola coma, dicho período". A continuación, el motor de reconocimiento devuelve un RecognizedPhrase que contiene cinco RecognizedWordUnit objetos que contienen las siguientes cadenas con los DisplayAttributes valores siguientes.

Elemento	DisplayAttributes
Hola	OneTrailingSpace
,	OneTrailingSpace | ConsumeLeadingSpaces
he	OneTrailingSpace
dicho	OneTrailingSpace
.	OneTrailingSpace | ConsumeLeadingSpaces

El texto devuelto para esta frase reconocida se imprime como: "Hola".

Consulte también

• RecognizedPhrase
• RecognitionResult
• RecognizedWordUnit
• ReplacementText