다음을 통해 공유

ITfReadOnlyProperty::GetValue 메서드(msctf.h)

  • 아티클

텍스트 범위에 대한 속성 값을 가져옵니다.

구문

HRESULT GetValue(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] VARIANT      *pvarValue
);

매개 변수

[in] ec

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

[in] pRange

속성을 가져올 범위를 지정하는 ITfRange 인터페이스에 대한 포인터입니다.

[out] pvarValue

속성 값을 받는 VARIANT 값에 대한 포인터입니다. 이 값의 데이터 형식 및 콘텐츠는 속성 소유자에 의해 정의되며 이 값을 사용하려면 호출자가 인식해야 합니다. 호출자는 이 값을 VariantClear API에 전달하여 더 이상 필요하지 않은 경우 이 데이터를 해제해야 합니다.

반환 값

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

값 Description
S_OK
 메서드를 성공적으로 수행했습니다.
S_FALSE
 범위는 속성에서 다루지 않거나 범위에 둘 이상의 속성 값이 포함되어 있습니다. pvarValue 는 VT_EMPTY 값을 받습니다.
E_INVALIDARG
 하나 이상의 매개 변수가 잘못되었습니다.
E_FAIL
 지정되지 않은 오류가 발생했습니다.
TF_E_NOLOCK
 ec로 식별된 편집 컨텍스트에는 읽기 전용 또는 읽기/쓰기 잠금이 없습니다.

설명

속성에 pRange에 대한 값이 없으면 pRange 에 속성 값이 둘 이상 포함되거나 속성이 pRange를 완전히 다루지 않으면 pvarValue 는 VT_EMPTY 값을 받고 메서드는 S_FALSE 반환합니다.


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->||<-



COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|    |<-



COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|             |<-

요구 사항

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

참고 항목

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfReadOnlyProperty