Método IPenInputPanel::EnableTsf (peninputpanel.h)

  • Artículo

[ PenInputPanel se ha reemplazado por el Panel de entrada de texto (TIP)].]

En desuso. Obtiene o establece un valor booleano que indica si el objeto PenInputPanel intenta enviar texto al control adjunto a través de Text Services Framework (TSF) y habilita el uso de la interfaz de usuario de corrección .

Sintaxis

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Parámetros

Enable

TRUE si el objeto PenInputPanel debe intentar enviar texto al control adjunto mediante TSF y que se debe habilitar la interfaz de usuario de corrección; en caso contrario , FALSE. El valor predeterminado es TRUE.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_UNEXPECTED
 Tipo de propiedad o parámetro inesperado.
E_NOINTERFACE
 Las interfaces TSF no se exponen en el control adjunto.
E_FAIL
 Se ha producido un error no especificado.

Comentarios

Llamar a este método con Enable establecido en TRUE hace que el objeto PenInputPanel intente iniciar el TSF en el control adjunto.

EnableTsf debe usarse para permitir que PenInputPanel use el contexto de inserción de TSF en lugar de la función SendInput para enviar los resultados del reconocimiento de escritura a mano al control. El resultado es que el texto se puede insertar incluso si el campo ya no tiene el foco.

Al llamar a EnableTsf con un valor true, el objeto PenInputPanel envía un mensaje EM_SETEDITSTYLE al control adjunto. Si el control no admite este mensaje, los resultados pueden ser impredecibles. El control InkEdit admite TSF.

Compatibilidad con aplicaciones heredadas

Se ha agregado compatibilidad a TSF y Microsoft Windows para proporcionar una interfaz de usuario coherente para todas las aplicaciones en todo el escritorio. Esta nueva compatibilidad permite que las aplicaciones o controles heredados que no sean conscientes de TSF aprovechen algunos servicios de texto avanzados de forma gratuita. Por ejemplo, el dictado de voz y la escritura a mano ahora se pueden usar para escribir texto en un documento en cualquier aplicación.

Esta nueva característica está disponible y habilitada de forma predeterminada en Windows XP Tablet PC Edition. Para habilitarlo o deshabilitarlo:

  1. En Panel de control, haga clic en Opciones regionales y de idioma.
  2. En la pestaña Idiomas , haga clic en Detalles.
  3. En la pestaña Avanzadas del cuadro de diálogo Text Services and Input Languages (Servicios de texto y idiomas de entrada ), seleccione o desactive Extender la compatibilidad de servicios de texto avanzados a todos los programas.
Si se ejecuta correctamente, el texto se envía al control adjunto a través de TSF. Además, si el control admite TSF (y no simplemente recibe texto de TSF simplemente porque Advanced Text Services se ha habilitado para todos los programas de Panel de control como se indicó anteriormente), la interfaz de usuario de corrección aparece en el control y permite el acceso a alternativas de escritura a mano. Llamar a este método con Enable establecido en FALSE hace que el objeto PenInputPanel intente apagar TSF en el control adjunto.

Requisitos

   
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado peninputpanel.h
Library InkObj.dll

Consulte también

IPenInputPanel

PenInputPanel