ITfInputScope インターフェイス (inputscope.h)

  • [アーティクル]

ITfInputScope インターフェイスは、ウィンドウに関連付けられたドキュメント コンテキストを表す InputScope 値を取得するために、テキスト入力プロセッサによって使用されます。 入力スコープには、音声と手書きの認識に役立つルールが用意されています。 たとえば、フォーム上のテキスト ボックスを使用してアドレスを入力する場合、そのテキスト ボックスの入力範囲を設定して、アドレスに対して有効な文字のみを認識して受け入れることもできます。

インターフェイス ID がIID_ITfInputScope。

ドキュメント コンテキストは、音声認識エンジンと手書き認識エンジンによって使用され、 SetInputScope メソッドを呼び出すことによってテキスト入力プロセッサによって設定されます。 TSF 対応アプリケーションは SetInputScope を 直接呼び出すのではなく、 ITextStoreACP または ITfContextOwner を実装して ITfInputScope へのポインターを取得します。

ITfInputScope インターフェイスへのポインターを取得するには、次の例のように、テキスト入力プロセッサまたは TSF 対応アプリケーションが ITfContext::GetAppProperty を呼び出し、GUID_PROP_INPUTSCOPEと ITFReadOnlyProperty インターフェイスへのポインターを渡します。


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
}

継承

ITfInputScope インターフェイスは、IUnknown インターフェイスから継承されます。 ITfInputScope には、次の種類のメンバーもあります。

メソッド

ITfInputScope インターフェイスには、これらのメソッドがあります。

 
ITfInputScope::GetInputScopes

ITfInputScope::GetInputScopes メソッド
ITfInputScope::GetPhrase

ITfInputScope::GetPhrase メソッド
ITfInputScope::GetRegularExpression

ITfInputScope::GetRegularExpression メソッド
ITfInputScope::GetSRGS

ITfInputScope::GetSRGS メソッド
ITfInputScope::GetXML

ITfInputScope::GetXML メソッド

注釈

ウィンドウのないコントロールでこのインターフェイスを使用するには、アプリケーションに 2 つのオプションがあります。

  1. アプリケーションを TSF 対応にする: TSF 対応アプリケーションは、ITfInputScope へのポインターを取得するために ITextStoreACP または ITfContextOwner を実装する必要があります。
  2. SetInputScopes これは推奨されませんが、アプリケーションが TSF 対応でない場合は、入力スコープとアプリケーションの間の関連付けを維持する他の方法はありません。 この場合、ウィンドウのないコントロール間でフォーカスが変更されるたびに、アプリケーションは SetInputScopes を呼び出す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー inputscope.h