ITfInputScope-Schnittstelle (inputscope.h)

Die ITfInputScope-Schnittstelle wird von den Texteingabeprozessoren verwendet, um den InputScope-Wert abzurufen, der einen einem Fenster zugeordneten Dokumentkontext darstellt. Der Eingabebereich bietet Regeln zur Unterstützung der Sprach- und Handschrifterkennung. Wenn für instance ein Textfeld in einem Formular verwendet wird, um eine Adresse einzugeben, kann der Eingabebereich für dieses Textfeld so festgelegt werden, dass nur die Zeichen erkannt und akzeptiert werden, die für eine Adresse gültig sind.

Die Schnittstellen-ID ist IID_ITfInputScope.

Der Dokumentkontext wird von der Sprach- und Handschrifterkennungs-Engine verwendet und von einem Texteingabeprozessor durch Aufrufen der SetInputScope-Methode festgelegt. Eine TSF-fähige Anwendung ruft SetInputScope nicht direkt auf, sondern implementiert entweder ITextStoreACP oder ITfContextOwner , um einen Zeiger auf ITfInputScope zu erhalten.

Um den Zeiger auf die ITfInputScope-Schnittstelle abzurufen, ruft der Texteingabeprozessor oder die TSF-fähige Anwendung ITfContext::GetAppProperty auf und übergibt wie im folgenden Beispiel GUID_PROP_INPUTSCOPE und einen Zeiger auf die ITFReadOnlyProperty-Schnittstelle .

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
}

Vererbung

Die ITfInputScope-Schnittstelle erbt von der IUnknown-Schnittstelle . ITfInputScope verfügt auch über folgende Membertypen:

Methoden

Die ITfInputScope-Schnittstelle verfügt über diese Methoden.

Hinweise

Um diese Schnittstelle mit Steuerelementen ohne Fenster zu verwenden, verfügt eine Anwendung über zwei Optionen.

1. Sorgen Sie dafür, dass die Anwendung TSF-fähig ist: Eine TSF-fähige Anwendung muss entweder ITextStoreACP oder ITfContextOwner implementieren, um einen Zeiger auf ITfInputScope zu erhalten.
2. SetInputScopes Dies wird nicht empfohlen, aber wenn die Anwendung nicht TSF-fähig ist, gibt es keine andere Möglichkeit, die Zuordnung zwischen dem Eingabebereich und der Anwendung beizubehalten. In diesem Fall muss die Anwendung SetInputScopes aufrufen, wenn sich der Fokus zwischen Steuerelementen ohne Fenster ändert.

Anforderungen