ITfContextComposition::StartComposition 메서드(msctf.h)

새 컴퍼지션을 만듭니다.

구문

HRESULT StartComposition(
  [in]  TfEditCookie       ecWrite,
  [in]  ITfRange           *pCompositionRange,
  [in]  ITfCompositionSink *pSink,
  [out] ITfComposition     **ppComposition
);

매개 변수

[in] ecWrite

편집 컨텍스트를 식별하는 편집 쿠키를 포함합니다. ITfEditSession::D oEditSession에서 가져옵니다.

[in] pCompositionRange

컴퍼지션이 처음에 다루는 텍스트를 지정하는 ITfRange 개체에 대한 포인터입니다.

[in] pSink

컴퍼지션 이벤트 알림을 받는 ITfCompositionSink 개체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 제공된 경우 컴퍼지션이 종료되면 개체가 해제됩니다.

[out] ppComposition

새 컴퍼지션 개체를 수신하는 ITfComposition 인터페이스 포인터에 대한 포인터입니다. 컨텍스트 소유자가 컴퍼지션을 거부하는 경우 이 매개 변수는 NULL 을 받습니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다. 컨텍스트 소유자 컴퍼지션이 싱크에서 컴퍼지션을 거부하면 ppComposition 이 NULL로 설정됩니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	컴퍼지션 개체를 만들 수 없습니다.
E_UNEXPECTED	메서드는 다른 컴퍼지션 작업 내에서 호출되었습니다.
TF_E_DISCONNECTED	컨텍스트 개체가 문서 스택에 없습니다.
TF_E_NOLOCK	ecWrite로 식별되는 편집 컨텍스트에는 읽기/쓰기 잠금이 없습니다.

설명

컨텍스트 소유자가 컨텍스트 소유자 컴퍼지션 advise 싱크를 설치한 경우 ITfContextOwnerCompositionSink::OnStartComposition 메서드가 호출됩니다. advise 싱크가 새 컴퍼지션을 거부하는 경우 이 메서드는 S_OK 반환하지만 ppComposition 은 NULL로 설정됩니다.

pCompositionRange에서 다루는 모든 텍스트는 GUID_PROP_COMPOSING 속성을 받습니다.

요구 사항

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

참고 항목

IEnumITfCompositionView 인터페이스, ITfContextComposition 인터페이스, ITfRange 인터페이스, ITfCompositionSink 인터페이스, ITfContextOwnerCompositionSink::OnStartComposition, ITfEditSession::D oEditSession