Función SetInputScope (inputscope.h)

Establece un ámbito de entrada para la ventana especificada.

Sintaxis

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

Parámetros

[in] hwnd

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

[in] inputscope

Ámbito de entrada que se va a asociar a la ventana. Para quitar la asociación de ámbito de entrada, pase IS_DEFAULT a este parámetro.

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.

Una aplicación debe llamar a este método, pasando IS_DEFAULT al parámetro hwnd , para quitar la asociación de ámbito de entrada antes de que se destruya 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 envían notificaciones de servicio de texto a clientes interesados (como el teclado táctil) que pueden querer responder al cambio de ámbito.

Ejemplos

[C++]

En el código siguiente se muestra cómo establecer un ámbito de entrada para una ventana.

SetInputScope(hwnd, IS_EMAIL_USERNAME);

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