ITfFnSearchCandidateProvider 인터페이스(ctffunc.h)

IME(입력 방법 편집기)에서 통합 검색 환경을 사용하도록 설정합니다.

상속

ITfFnSearchCandidateProvider 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ITfFnSearchCandidateProvider 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ITfFnSearchCandidateProvider 인터페이스에는 이러한 메서드가 있습니다.

ITfFnSearchCandidateProvider::GetSearchCandidates IME 관련 메시지 또는 이벤트를 생성하지 않고 지정된 문자열의 변환 후보 목록을 가져옵니다.
ITfFnSearchCandidateProvider::SetResult 사용자가 후보를 선택할 때 기록 데이터가 포함된 텍스트 서비스 또는 IME를 제공합니다.

설명

IME(입력 방법 편집기)에서 ITfFnSearchCandidateProvider 인터페이스를 구현하여 통합 검색 환경을 사용하도록 설정합니다. 이 인터페이스를 구현하면 지정된 입력 문자열에 대해 가능한 IME 변환 후보 집합을 제공하여 IME 입력이 완료되기 전에 의미 있는 결과가 있는 검색을 시작할 수 있습니다. 앱은 이 인터페이스를 사용하여 문자열에 대한 IME 변환을 가져올 수 있으므로 ITfFnGetLinguisticAlternates와 함께 ITfFnSearchCandidateProvider 인터페이스는 ImmGetConversionList 함수에 대한 TSF 기반 대체를 제공합니다. 일반적으로 IME는 ITfFnGetLinguisticAlternates 또는 ITfFnSearchCandidateProvider (또는 둘 다)를 구현합니다.

텍스트 서비스의 CLSID를 사용하여 GetFunctionProvider를 호출하여 ITfFunctionProvider instance 가져옵니다. ITfFnSearchCandidateProvider 인터페이스 포인터를 얻으려면 ITfFunctionProvider::GetFunction 메서드에 대한 다음 호출을 사용합니다.

ITfFunctionProvider::GetFunction(GUID_NULL, IID_ITfFnSearchCandidateProvider, &pSearchCandidate)

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ctffunc.h

추가 정보

GetFunction

GetFunctionProvider

IUnknown

SearchPaneQueryLinguisticDetails