ITfProperty::SetValue 메서드(msctf.h)

범위에 대한 속성 값을 설정합니다.

구문

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

[in] ec

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

[in] pRange

속성 값이 설정된 범위를 포함하는 ITfRange 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다. pRange가 비어 있으면 이 메서드가 실패합니다.

[in] pvarValue

새 속성 값이 포함된 VARIANT 구조체에 대한 포인터입니다. 형식 VT_I4, VT_UNKNOWN, VT_BSTR 및 VT_EMPTY 값만 지원됩니다.

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	메모리 할당 오류가 발생했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
TF_E_NOLOCK	ec로 식별된 편집 컨텍스트에는 읽기/쓰기 잠금이 없습니다.
TF_E_READONLY	편집 컨텍스트는 읽기 전용입니다.
TF_E_NOTOWNEDRANGE	TSF 관리자는 범위를 소유하지 않습니다.

이 메서드를 사용하여 설정된 속성 값은 속성 값에 포함된 텍스트가 수정될 때 삭제됩니다. 텍스트 편집에 대한 값 응답에 대한 사용자 지정 제어를 얻으려면 ITfProperty::SetValueStore를 사용합니다.

이 메서드를 사용하여 설정된 값은 직렬화되지 않은 VT_UNKNOWN 형식의 값을 제외하고 직렬화됩니다. VT_UNKNOWN 형식의 속성 값을 직렬화해야 하는 경우 대신 ITfProperty::SetValueStore 를 사용합니다.

동일한 형식의 겹치는 속성 값은 지원되지 않습니다.

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