ITfCandidateList::SetResult 메서드(ctffunc.h)

특정 후보 문자열에 대한 재구성 작업의 결과를 지정합니다.

구문

HRESULT SetResult(
  [in] ULONG             nIndex,
  [in] TfCandidateResult imcr
);

[in] nIndex

결과를 설정할 후보 문자열의 인덱스(0부터 시작)를 지정합니다. imcr에 CAND_CANCELED 포함된 경우 이 매개 변수는 무시됩니다.

[in] imcr

재구성 작업의 결과를 지정하는 TfCandidateResult 값 중 하나를 포함합니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

일반적인 재구성 작업에는 다음 작업이 포함됩니다.

후보 목록을 가져오고 대화 상자에서 사용자에게 표시합니다.
사용자가 후보를 선택하지만 대화 상자가 해제되기 전에 새로 선택한 후보 및 CAND_SELECTED 인덱스를 사용하여 ITfCandidateList::SetResult 가 호출됩니다.
다른 후보를 선택하면 새로 선택한 후보 및 CAND_SELECTED 인덱스를 사용하여 ITfCandidateList::SetResult 가 다시 호출됩니다.
사용자가 새 후보를 수락하도록 선택하면 현재 선택한 후보 및 CAND_FINALIZED 인덱스를 사용하여 ITfCandidateList::SetResult 가 호출됩니다.
사용자가 대화 상자를 취소하면 ITfCandidateList::SetResult 가 인덱스 0으로 호출되고 CAND_CANCELED.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	ctffunc.h
DLL	Tiptsf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0