ITfInputScope 인터페이스(inputscope.h)

ITfInputScope 인터페이스는 텍스트 입력 프로세서에서 창과 연결된 문서 컨텍스트를 나타내는 InputScope 값을 가져오는 데 사용됩니다. 입력 scope 음성 및 필기 인식에 도움이 되는 규칙을 제공합니다. instance 경우 양식의 텍스트 상자가 주소를 입력하는 데 사용되는 경우 해당 텍스트 상자에 대한 입력 scope 설정하여 주소에 유효한 문자만 인식하고 수락할 수 있습니다.

인터페이스 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 메서드

설명

창 없는 컨트롤에서 이 인터페이스를 사용하려면 애플리케이션에 두 가지 옵션이 있습니다.

1. 애플리케이션 TSF를 인식하게 합니다.TSF 인식 애플리케이션은 ITfInputScope에 대한 포인터를 얻으려면 ITextStoreACP 또는 ITfContextOwner를 구현해야 합니다.
2. SetInputScopes 권장되지는 않지만 애플리케이션이 TSF를 인식하지 않는 경우 입력 scope 애플리케이션 간의 연결을 유지하는 다른 방법은 없습니다. 이 경우 애플리케이션은 창 없는 컨트롤 간에 포커스가 변경 될 때마다 SetInputScopes를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	inputscope.h