Interface ITfInputScope (inputscope.h)

A interface ITfInputScope é usada pelos processadores de entrada de texto para obter o valor InputScope que representa um contexto de documento associado a uma janela. O escopo de entrada fornece regras para ajudar o reconhecimento de fala e manuscrito. Por exemplo, se uma caixa de texto em um formulário for usada para inserir um endereço, o escopo de entrada dessa caixa de texto poderá ser definido para reconhecer e aceitar apenas os caracteres válidos para um endereço.

A ID da interface é IID_ITfInputScope.

O contexto do documento é usado pelo mecanismo de reconhecimento de fala e manuscrito e é definido por um processador de entrada de texto chamando o método SetInputScope . Um aplicativo com reconhecimento de TSF não chama SetInputScope diretamente, mas implementa ITextStoreACP ou ITfContextOwner para obter um ponteiro para ITfInputScope.

Para obter o ponteiro para a interface ITfInputScope , o processador de entrada de texto ou o aplicativo com reconhecimento de TSF chama ITfContext::GetAppProperty, passando GUID_PROP_INPUTSCOPE e um ponteiro para a interface ITFReadOnlyProperty , como no exemplo a seguir.

extern const GUID GUID_PROP_INPUTSCOPE;
// 
// The TIP can call this to get the input scope of the document mgr. 
// 
HRESULT GetInputScope(ITfContext *pic, ITfRange *pRange, TfEditCookie ec, ITfInutScope **ppiscope){
    ITFReadOnlyProperty *prop;
    HRESULT hr;
    If (SUCCEEDED(hr = pic->GetAppProperty(GUID_PROP_INPUTSCOPE, &prop))
    {   VARIANT var;
        If (SUCCEEDED(hr = prop->GetValue(ec, pRange, &var)))
        {  hr = var.punkVal->QueryInterface(IID_ITfInputScope, (void **)ppiscope);
        }
        prop->Release();
    }
    return hr
}

Herança

A interface ITfInputScope herda da interface IUnknown . ITfInputScope também tem estes tipos de membros:

Métodos

A interface ITfInputScope tem esses métodos.

ITfInputScope::GetInputScopes Método ITfInputScope::GetInputScopes
ITfInputScope::GetPhrase Método ITfInputScope::GetPhrase
ITfInputScope::GetRegularExpression Método ITfInputScope::GetRegularExpression
ITfInputScope::GetSRGS Método ITfInputScope::GetSRGS
ITfInputScope::GetXML Método ITfInputScope::GetXML

Comentários

Para usar essa interface com controles sem janela, um aplicativo tem duas opções.

1. Torne o aplicativo com reconhecimento de TSF: Um aplicativo com reconhecimento de TSF deve implementar ITextStoreACP ou ITfContextOwner para obter um ponteiro para ITfInputScope.
2. SetInputScopes Isso não é recomendado, mas se o aplicativo não tiver reconhecimento de TSF, não haverá outra maneira de manter a associação entre o escopo de entrada e o aplicativo. Nesse caso, o aplicativo deve chamar SetInputScopes sempre que o foco for alterado entre controles sem janela.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	inputscope.h