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 |