ITfContextView::GetRangeFromPoint 메서드(msctf.h)

ITfContextView::GetRangeFromPoint 메서드는 화면 좌표의 점을 해당 위치에 배치된 빈 텍스트 범위로 변환합니다.

구문

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

매개 변수

[in] ec

읽기 전용 액세스 권한이 있는 편집 쿠키를 지정합니다.

[in] ppt

화면 좌표의 점을 지정합니다.

[in] dwFlags

문자 경계 상자 지점의 화면 좌표에 따라 반환할 범위 위치를 지정합니다. 기본적으로 반환되는 범위 위치는 점의 화면 좌표를 포함하는 문자 경계 상자입니다. 점이 문자 경계 상자 밖에 있으면 메서드는 NULL 또는 TF_E_INVALIDPOINT 반환합니다. 이 매개 변수의 다른 비트 플래그는 다음과 같습니다.

비트 플래그를 결합할 수 있습니다.

값	의미
GXFPF_ROUND_NEAREST	점의 화면 좌표가 문자 경계 상자에 포함된 경우 반환되는 범위 위치는 점의 화면 좌표에 가장 가까운 경계 가장자리입니다.
GXFPF_NEAREST	점의 화면 좌표가 문자 경계 상자에 포함되지 않으면 가장 가까운 범위 위치가 반환됩니다.

[out] ppRange

ITfRange 인터페이스에 대한 포인터를 받습니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_E_INVALIDPOINT	pptScreen 매개 변수는 문서 텍스트를 다루지 않습니다.
TF_E_NOLAYOUT	애플리케이션에서 텍스트 레이아웃을 계산하지 않았습니다.
TF_E_NOLOCK	지정한 편집 쿠키가 잘못되었습니다.

설명

기본적으로 메서드는 점 1에 대해 0에 배치된 범위를 반환하고 점 2에 대해 TF_E_INVALIDPOINT. dwFlags 매개 변수가 GXFPF_ROUND_NEAREST 설정된 경우 메서드는 점 1의 범위 위치 1을 반환합니다. dwFlags 매개 변수가 GXFPF_NEAREST 설정된 경우 메서드는 점 2의 범위 위치 2를 반환합니다.

요구 사항

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

추가 정보

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT