ITextStoreACP::SetText 메서드(textstor.h)

아티클
03/02/2024

ITextStoreACP::SetText 메서드는 텍스트 선택 영역을 제공된 문자 위치로 설정합니다.

구문

HRESULT SetText(
  [in]  DWORD         dwFlags,
  [in]  LONG          acpStart,
  [in]  LONG          acpEnd,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [out] TS_TEXTCHANGE *pChange
);

매개 변수

[in] dwFlags

TS_ST_CORRECTION 값으로 설정된 경우 텍스트는 기존 콘텐츠의 변환(수정)이며 파일 데이터 또는 언어 식별자 .wav 같은 특수 텍스트 태그 정보(메타데이터)가 유지됩니다. 클라이언트는 보존할 태그 정보의 유형을 정의합니다.

[in] acpStart

바꿀 텍스트의 시작 문자 위치를 지정합니다.

[in] acpEnd

바꿀 텍스트의 끝 문자 위치를 지정합니다. 값이 1이면 이 매개 변수는 무시됩니다.

[in] pchText

대체 텍스트에 대한 포인터를 지정합니다. 텍스트 문자 수가 cch 매개 변수에 지정되므로 텍스트 문자열을 NULL로 종료할 필요가 없습니다.

[in] cch

대체 텍스트의 문자 수를 지정합니다.

[out] pChange

다음 데이터가 있는 TS_TEXTCHANGE 구조체에 대한 포인터입니다.

값	의미
acpStart	텍스트가 문서에 삽입되기 전의 시작 응용 프로그램 문자 위치입니다.
acpOldEnd	텍스트가 문서에 삽입되기 전의 끝 위치입니다. 이 값은 삽입 지점의 acpStart 와 동일합니다. 이 값이 acpStart와 다른 경우 텍스트 삽입 전에 텍스트가 선택되었습니다.
acpNewEnd	텍스트 삽입 후의 끝 위치입니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TS_E_INVALIDPOS	acpStart 또는 acpEnd 매개 변수는 문서 텍스트 외부에 있습니다.
TS_E_NOLOCK	호출자에게 읽기/쓰기 잠금이 없습니다.
TS_E_READONLY	문서는 읽기 전용입니다. 콘텐츠를 수정할 수 없습니다.
TS_E_REGION	영역 경계를 넘어 텍스트를 수정하려고 했습니다.

설명

애플리케이션은 먼저 ITextStoreACP::InsertTextAtSelection을 사용하여 컴퍼지션을 시작해야 합니다. ITextStoreACP::SetText 는 기존 컴퍼지션 내에서만 사용해야 합니다. SetText가 호출되는 시점에 활성 컴퍼지션이 없는 경우 TSF 관리자는 SetText 호출을 래핑할 수 있을 만큼 오래 지속되는 컴퍼지션을 만듭니다.

acpStart 및 acpEnd 문자 위치는 문서 범위 밖에 있을 수 없습니다.

애플리케이션은 이 메서드에 대한 응답으로 ITextStoreACPSink::OnTextChange 메서드를 호출하면 안 됩니다.

이 메서드는 ITextStoreACP::SetSelection 메서드를 호출하여 변경할 텍스트를 선택해야 합니다. ITextStoreACP::SetSelection 메서드를 성공적으로 실행한 후 이 메서드는 ITextStoreACP::InsertTextAtSelection 메서드를 호출하여 실제 텍스트 변경을 수행합니다.

요구 사항

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