Interface ITfInputScope (inputscope.h)

Article
03/02/2024

L’interface ITfInputScope est utilisée par les processeurs d’entrée de texte pour obtenir la valeur InputScope qui représente un contexte de document associé à une fenêtre. L’étendue d’entrée fournit des règles pour faciliter la reconnaissance vocale et l’écriture manuscrite. Par instance, si une zone de texte d’un formulaire est utilisée pour entrer une adresse, l’étendue d’entrée de cette zone de texte peut être définie pour reconnaître et accepter uniquement les caractères valides pour une adresse.

L’ID d’interface est IID_ITfInputScope.

Le contexte du document est utilisé par le moteur de reconnaissance vocale et d’écriture manuscrite et est défini par un processeur d’entrée de texte en appelant la méthode SetInputScope . Une application prenant en charge TSF n’appelle pas Directement SetInputScope , mais implémente plutôt ITextStoreACP ou ITfContextOwner pour obtenir un pointeur vers ITfInputScope.

Pour obtenir le pointeur vers l’interface ITfInputScope , le processeur d’entrée de texte ou l’application prenant en compte TSF appelle ITfContext ::GetAppProperty, en passant GUID_PROP_INPUTSCOPE et un pointeur vers l’interface ITFReadOnlyProperty, comme dans l’exemple suivant.


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
}

Héritage

L’interface ITfInputScope hérite de l’interface IUnknown. ITfInputScope a également les types de membres suivants :

Méthodes

L’interface ITfInputScope a ces méthodes.


ITfInputScope ::GetInputScopes Méthode ITfInputScope ::GetInputScopes
ITfInputScope ::GetPhrase ITfInputScope ::GetPhrase, méthode
ITfInputScope ::GetRegularExpression Méthode ITfInputScope ::GetRegularExpression
ITfInputScope ::GetSRGS Méthode ITfInputScope ::GetSRGS
ITfInputScope ::GetXML ITfInputScope ::GetXML, méthode

Remarques

Pour utiliser cette interface avec des contrôles sans fenêtre, une application a deux options.

Rendre l’application compatible TSF : Une application prenant en compte TSF doit implémenter ITextStoreACP ou ITfContextOwner pour obtenir un pointeur vers ITfInputScope.
SetInputScopes Cela n’est pas recommandé, mais si l’application ne prend pas en compte TSF, il n’existe aucun autre moyen de maintenir l’association entre l’étendue d’entrée et l’application. Dans ce cas, l’application doit appeler SetInputScopes chaque fois que le focus change entre les contrôles sans fenêtre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	inputscope.h

Share via