Condividi tramite

Interfaccia ITfInputScope (inputscope.h)

  • Articolo

L'interfaccia ITfInputScope viene usata dai processori di input di testo per ottenere il valore InputScope che rappresenta un contesto di documento associato a una finestra. L'ambito di input fornisce regole per consentire il riconoscimento vocale e della grafia. Ad esempio, se viene usata una casella di testo in un modulo per immettere un indirizzo, l'ambito di input per tale casella di testo può essere impostato per riconoscere e accettare solo i caratteri validi per un indirizzo.

L'ID interfaccia è IID_ITfInputScope.

Il contesto del documento viene usato dal motore di riconoscimento vocale e di scrittura e viene impostato da un processore di input di testo chiamando il metodo SetInputScope . Un'applicazione con riconoscimento TSF non chiama direttamente SetInputScope , ma implementa invece ITextStoreACP o ITfContextOwner per ottenere un puntatore a ITfInputScope.

Per ottenere il puntatore all'interfaccia ITfInputScope , il processore di input di testo o l'applicazione con riconoscimento TSF chiama ITfContext::GetAppProperty, passando GUID_PROP_INPUTSCOPE e un puntatore all'interfaccia ITFReadOnlyProperty , come nell'esempio seguente.


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
}

Ereditarietà

L'interfaccia ITfInputScope eredita dall'interfaccia IUnknown . ITfInputScope include anche questi tipi di membri:

Metodi

L'interfaccia ITfInputScope include questi metodi.

 
ITfInputScope::GetInputScopes

Metodo ITfInputScope::GetInputScopes
ITfInputScope::GetPhrase

Metodo ITfInputScope::GetPhrase
ITfInputScope::GetRegularExpression

Metodo ITfInputScope::GetRegularExpression
ITfInputScope::GetSRGS

Metodo ITfInputScope::GetSRGS
ITfInputScope::GetXML

Metodo ITfInputScope::GetXML

Commenti

Per usare questa interfaccia con controlli senza finestra, un'applicazione dispone di due opzioni.

  1. Rendere l'applicazione TSF a conoscenza: Un'applicazione con riconoscimento TSF deve implementare ITextStoreACP o ITfContextOwner per ottenere un puntatore a ITfInputScope.
  2. SetInputScopes Questa operazione non è consigliata, ma se l'applicazione non è a conoscenza del TSF, non esiste alcun altro modo per mantenere l'associazione tra l'ambito di input e l'applicazione. In questo caso, l'applicazione deve chiamare SetInputScopes ogni volta che lo stato attivo cambia tra i controlli senza finestra.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione inputscope.h