Compartilhar via

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

  • Artigo

[ O PenInputPanel foi substituído pelo Painel de Entrada de Texto (TIP).]

Preterido. Obtém ou define um valor booliano que indica se o objeto PenInputPanel tenta enviar texto para o controle anexado por meio do TSF ( Text Services Framework ) e permite o uso da interface do usuário de correção .

Sintaxe

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Parâmetros

Enable

TRUE se o objeto PenInputPanel deve tentar enviar texto para o controle anexado usando TSF e que a interface do usuário de correção deve ser habilitada; caso contrário , FALSE. O valor padrão é TRUE.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_UNEXPECTED
 Parâmetro inesperado ou tipo de propriedade.
E_NOINTERFACE
 As interfaces TSF não são expostas no controle anexado.
E_FAIL
 Ocorreu um erro não especificado.

Comentários

Chamar esse método com Enable definido como TRUE faz com que o objeto PenInputPanel tente iniciar o TSF no controle anexado.

EnableTsf deve ser usado para permitir que o PenInputPanel use o contexto de inserção TSF em vez da função SendInput para enviar os resultados do reconhecimento de manuscrito para o controle. O resultado é que o texto pode ser inserido mesmo se o campo não tiver mais foco.

Quando você chama EnableTsf com um valor TRUE, o objeto PenInputPanel envia uma mensagem EM_SETEDITSTYLE para o controle anexado. Se o controle não der suporte a essa mensagem, os resultados poderão ser imprevisíveis. O controle InkEdit dá suporte a TSF.

Suporte para aplicativos herdados

O suporte foi adicionado ao TSF e ao Microsoft Windows para fornecer uma interface do usuário consistente para todos os aplicativos em toda a área de trabalho. Esse novo suporte permite que aplicativos ou controles herdados que não estejam cientes do TSF aproveitem alguns serviços de texto avançados gratuitamente. Por exemplo, o ditado de fala e a manuscrito agora podem ser usados para inserir texto em um documento em qualquer aplicativo.

Esse novo recurso está disponível e habilitado por padrão no Windows XP Tablet PC Edition. Para habilitá-lo ou desabilitá-lo:

  1. Em Painel de Controle, clique em Opções Regionais e de Idioma.
  2. Na guia Idiomas , clique em Detalhes.
  3. Na guia Avançado da caixa de diálogo Serviços de Texto e Idiomas de Entrada , selecione ou desmarque Estender o suporte de serviços de texto avançados para todos os programas.
Se tiver êxito, o texto será enviado para o controle anexado por meio do TSF. Além disso, se o controle der suporte a TSF (e não estiver simplesmente recebendo texto do TSF apenas porque os Serviços avançados de texto foram habilitados para todos os programas em Painel de Controle conforme observado acima), a interface do usuário de correção aparecerá no controle e permitirá o acesso a alternativas de manuscrito. Chamar esse método com Habilitar definido como FALSE faz com que o objeto PenInputPanel tente desligar o TSF no controle anexado.

Requisitos

   
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho peninputpanel.h
Biblioteca InkObj.dll

Confira também

IPenInputPanel

Peninputpanel