ITfRange::AdjustForInsert 메서드(msctf.h)

아티클
08/24/2023

ITfRange::AdjustForInsert 메서드는 텍스트 삽입을 위해 조정할 텍스트 범위를 확장하거나 축소합니다.

구문

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

매개 변수

[in] ec

ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져온 쿠키를 편집합니다.

[in] cchInsert

삽입된 텍스트의 문자 수입니다. 이 개수는 ITfRange::SetText에 대한 futurecall에 사용됩니다. 문자 수를 알 수 없는 경우 0을 사용할 수 있습니다.

[out] pfInsertOk

컨텍스트 소유자가 삽입을 수락할지(TRUE) 또는 거부(FALSE)할지 여부를 나타내는 플래그에 대한 포인터입니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	메서드가 실패했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_NOTIMPL	애플리케이션에서 선택을 바꿀 수 없습니다.
TF_E_NOLOCK	ec 매개 변수의 값이 잘못된 쿠키이거나 호출자에게 읽기 전용 잠금이 없습니다.

설명

이 메서드는 편집을 시작하기 전에 새 컴퍼지션을 시작할 범위를 준비하는 데 사용해야 합니다. 현재 선택 영역에 텍스트가 삽입되지 않은 경우에만 사용해야 합니다. ITFInsertAtSelection:InsertTextAtSelection 또는 ITfInsertAtSelection::InsertEmbeddedAtSelection 은 현재 선택 영역에 텍스트를 삽입할 때 사용할 올바른 메서드입니다.

컨텍스트 소유자는 이 메서드를 사용하여 동작을 유지하고 일관된 사용자 환경을 유지할 수 있습니다. 예를 들어 컨텍스트의 특정 문자 또는 개체는 수정에서 유지되거나 과잉 서식을 지원될 수 있습니다.

이 메서드는 기존 컴퍼지션을 수정할 때 필요하지 않습니다. ITfRange::SetText를 직접 호출하여 호출자가 이전에 입력한 텍스트를 수정할 수 있습니다.

종료 시 *pfInsertOk 가 FALSE로 설정된 경우 이 범위를 사용하여 ITfRange::SetText 또는 ITfRange::InsertEmbedded 에 대한 향후 호출이 실패할 수 있습니다. 그렇지 않으면 *pfInsertOk 가 TRUE로 설정되고 범위 시작 앵커 또는 끝 앵커는 컨텍스트 소유자의 재량에 따라 위치가 변경될 수 있습니다.

요구 사항

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