ITfContextOwner::GetTextExt 메서드(msctf.h)

ITfContextOwner::GetTextExt 메서드는 지정된 문자 위치에 있는 텍스트의 경계 상자를 화면 좌표로 반환합니다. 호출자는 이 메서드를 호출하기 전에 문서에 대한 읽기 전용 잠금이 있어야 합니다.

구문

HRESULT GetTextExt(
  [in]  LONG acpStart,
  [in]  LONG acpEnd,
  [out] RECT *prc,
  [out] BOOL *pfClipped
);

[in] acpStart

문서에서 가져올 텍스트의 시작 문자 위치를 지정합니다.

[in] acpEnd

문서에서 가져올 텍스트의 끝 문자 위치를 지정합니다.

[out] prc

지정된 문자 위치에 있는 텍스트의 경계 상자를 화면 좌표로 받습니다.

[out] pfClipped

경계 상자의 텍스트가 잘렸는지 여부를 지정하는 부울 값을 받습니다. 이 매개 변수가 TRUE이면 경계 상자에 잘린 텍스트가 포함되며 요청된 전체 텍스트 범위가 포함되지 않습니다. 요청된 범위가 표시되지 않으므로 경계 상자가 잘립니다.

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TS_E_INVALIDARG	지정된 시작 문자와 끝 문자 위치가 같습니다.
TS_E_INVALIDPOS	acpStart 및 acpEnd 매개 변수로 지정된 범위는 문서 끝이나 문서 위쪽을 지나 확장됩니다.
TS_E_NOLAYOUT	애플리케이션에서 텍스트 레이아웃을 계산하지 않았습니다.
TS_E_NOLOCK	호출자에게 문서에 대한 읽기 전용 잠금이 없습니다.

문서 창이 최소화되거나 지정된 텍스트가 현재 표시되지 않으면 prc 매개 변수가 로 설정된 {0,0,0,0}S_OK 반환합니다.

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