ITfContextOwnerCompositionServices::TerminateComposition 메서드(msctf.h)
컴퍼지션을 종료합니다.
구문
HRESULT TerminateComposition(
[in] ITfCompositionView *pComposition
);
매개 변수
[in] pComposition
종료할 컴퍼지션을 나타내는 ITfCompositionView 인터페이스에 대한 포인터입니다. 이 값이 NULL이면 컨텍스트의 모든 컴퍼지션이 종료됩니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
값 | Description |
---|---|
|
메서드를 성공적으로 수행했습니다. |
|
컨텍스트가 문서 스택에 없습니다. |
|
텍스트 서비스는 현재 문서에 대한 잠금을 보유합니다. |
|
이 메서드는 다른 컴퍼지션 작업 중에 호출되었습니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
텍스트 서비스는 ITfComposition::EndComposition 을 사용하여 만든 컴퍼지션을 종료합니다.
컨텍스트 소유자가 텍스트 저장소를 구현하는 경우 컨텍스트 소유자는 이 메서드를 호출하기 전에 동기 쓰기 잠금을 부여할 수 있어야 합니다.
이 메서드는 다음도 수행합니다.
- 종료된 각 컴퍼지션에 대해 설치된 모든 컴퍼지션 advise 싱크 에 대해 ITfCompositionSink::OnCompositionTerminated 가 호출됩니다.
- 컨텍스트 소유자가 컨텍스트 소유자 컴퍼지션 advise 싱크를 설치한 경우 종료된 각 컴퍼지션 에 대해 ITfContextOwnerCompositionSink::OnEndComposition 이 호출됩니다.
- 종료된 각 컴퍼지션에서 다루는 텍스트에 대해 GUID_PROP_COMPOSING 속성이 지워질 것입니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | msctf.h |
DLL | Msctf.dll |
재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |
추가 정보
ITfComposition::EndComposition, nf-msctf-itfcompositionsink-oncompositionterminated, ITfCompositionView 인터페이스, ITfContextOwnerCompositionServices 인터페이스, ITfContextOwnerCompositionSink::OnEndComposition