Función SetInputScopes2 (inputscope.h)

La aplicación debe llamar a SetInputScope con IS_DEFAULT antes de que se destruya una ventana para borrar la referencia de la interfaz.

Sintaxis

HRESULT SetInputScopes2(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] IEnumString      *pEnumString,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parámetros

[in] hwnd

Ventana en la que se va a establecer el ámbito. Esta llamada reemplazará cualquier ámbito que pueda haber estado en el hwnd antes.

[in] pInputScopes

Puntero a una matriz de ámbitos de entrada. Puede ser NULL. Si no es NULL, todos los ámbitos contenidos en se establecerán como el ámbito de entrada del hwnd con una ponderación igual. Use IS_DEFAULT también para aceptar todas las demás entradas (esta es la opción "no coerce").

[in] cInputScopes

Recuento del número de ámbitos de entrada en pInputScopes. Debe ser cero si rgScopes es NULL, debe ser distinto de cero si pInputScopes no es NULL.

[in] pEnumString

Puntero de interfaz IenumString de la lista de frases.

[in] pszRegExp

Puntero a una cadena terminada en NULL que describe 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	El ámbito de entrada establecido o borrado correctamente.

Comentarios

La aplicación debe llamar a SetInputScope con IS_DEFAULT antes de que se destruya una ventana para borrar la referencia de la interfaz.

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