Función SetInputScopes (inputscope.h)

Establece una combinación de un ámbito de entrada, varios ámbitos de entrada, una lista de frases, una expresión regular o reglas de especificación de gramática de reconocimiento de voz (SRGS) para la ventana especificada.

Sintaxis

HRESULT SetInputScopes(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] PWSTR            *ppszPhraseList,
  [in] UINT             cPhrases,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parámetros

[in] hwnd

Ventana en la que se va a establecer el ámbito.

[in] pInputScopes

Puntero a una matriz de ámbitos de entrada. Puede ser NULL. Si no es NULL, todos los ámbitos de entrada de la matriz se establecen como el ámbito de entrada de la ventana con una ponderación igual. Use IS_DEFAULT para aceptar también todos los demás ámbitos de entrada.

[in] cInputScopes

Número de ámbitos de entrada de la matriz a la que apunta *pInputScopes. Este valor debe ser cero si la matriz es NULL.

[in] ppszPhraseList

Puntero a una matriz de punteros a frases terminadas en NULL. Puede ser NULL.

[in] cPhrases

Número de punteros a los que apunta **ppszPhraseList, que representa el número de frases.

[in] pszRegExp

Puntero a una cadena terminada en NULL que contiene la expresión regular que se va a reconocer. Puede ser NULL.

[in] pszSRGS

Puntero a una cadena XML terminada en NULL que proporciona sugerencias y reglas específicas de voz para ayudar en el reconocimiento de voz. El formato XML se ajusta al estándar de especificación de gramática de reconocimiento de voz (SRGS), descrito en http://www.w3.org/TR/speech-grammar. Puede ser NULL. $

Valor devuelto

Valor	Significado
S_OK	Método realizado correctamente.

Comentarios

Al llamar a este método, se reemplaza el ámbito asociado a la ventana.

Esta API solo funciona cuando la ventana (parámetro hwnd) y el subproceso que realiza la llamada se encuentran en el mismo subproceso. Si llama a esta API para una ventana de subproceso diferente, se produce un error con E_INVALIDARG.

Si llama a este método en una ventana (parámetro hwnd ) que no se ha asociado a un Administrador de documentos, no se enviarán notificaciones de servicio de texto a los clientes interesados (como el teclado táctil) que pueden querer responder al cambio de ámbito.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	inputscope.h
Archivo DLL	Msctf.dll