ITextStoreAnchor::GetAnchorFromPoint 메서드(textstor.h)
ITextStoreAnchor::GetAnchorFromPoint 메서드는 화면 좌표의 점을 해당 위치에 있는 앵커로 변환합니다.
구문
HRESULT GetAnchorFromPoint(
[in] TsViewCookie vcView,
[in] const POINT *ptScreen,
[in] DWORD dwFlags,
[out] IAnchor **ppaSite
);
매개 변수
[in] vcView
컨텍스트 뷰를 지정합니다.
[in] ptScreen
점의 화면 좌표가 있는 POINT 구조체에 대한 포인터입니다.
[in] dwFlags
문자 경계 상자를 기준으로 점의 화면 좌표를 기반으로 반환할 앵커 위치를 지정합니다. 기본적으로 반환되는 앵커 위치는 점의 화면 좌표를 포함하는 문자 경계 상자입니다. 점이 문자 경계 상자 밖에 있으면 메서드는 NULL 또는 TF_E_INVALIDPOINT 반환합니다. 이 매개 변수의 다른 비트 플래그는 다음과 같습니다.
비트 플래그를 결합할 수 있습니다.
| 값 | 의미 |
|---|---|
|
점의 화면 좌표가 문자 경계 상자에 포함되어 있으면 점의 화면 좌표에 가장 가까운 경계 가장자리에 앵커가 반환됩니다. |
|
점의 화면 좌표가 문자 경계 상자에 포함되지 않으면 가장 가까운 문자 위치에 있는 앵커가 반환됩니다. |
[out] ppaSite
화면 좌표 ptScreen에 해당하는 위치에 있는 앵커 개체에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
메서드가 실패했습니다. |
|
하나 이상의 입력 매개 변수가 잘못되었습니다. |
|
지정된 위치에서 앵커를 인스턴스화하지 못했습니다. |
|
ptScreen 매개 변수는 문자의 경계 상자 내에 있지 않습니다. |
|
애플리케이션은 아직 텍스트 레이아웃을 계산하지 않았습니다. |
설명
점 1 화면 좌표는 기본적으로 앵커 ppaSite 의 오프셋(문자 위치)을 0으로 설정하거나, 점 1 화면 좌표가 문자 위치 0의 문자 경계 상자 내에 있기 때문에 dwFlags 매개 변수를 GXFPF_NEAREST 설정됩니다. dwFlags 매개 변수가 점 1에 대해 GXFPF_ROUND_NEAREST 설정된 경우 점 1 화면 좌표가 범위 위치 1에 가장 가깝기 때문에 앵커 오프셋은 1입니다. 범위 위치 1은 문자 위치 1의 시작 범위 위치입니다.
점 2 화면 좌표의 경우 메서드는 기본적으로 TF_E_INVALIDPOINT 반환하거나 점 2 화면 좌표가 문자 경계 상자 밖에 있기 때문에 dwFlags 매개 변수가 GXFPF_NEAREST 설정되었는지 여부를 반환합니다. dwFlags 매개 변수를 GXFPF_ROUND_NEAREST 설정하면 점 2 화면 좌표에 가장 가까운 문자 위치가 문자 위치 1이므로 점 2 화면 좌표는 앵커 오프셋이 1이 됩니다.
핵심 사항 1
- 기본-- 앵커 오프셋 = 0 -- 화면 좌표점이 문자 위치 0의 문자 경계 상자 내에 있습니다.
- -- GXFPF_ROUND_NEAREST앵커 오프셋 = 1 --점의 화면 좌표는 문자 위치 1의 시작 범위 위치인 범위 위치 1에 가장 가깝습니다.
- -- GXFPF_NEAREST앵커 오프셋 = 0 --포인트가 문자 위치 0의 문자 경계 상자 내에 있기 때문에 기본 동작이 발생합니다.
- 기본값-- hr = TF_E_INVALIDPOINT -- 점의 화면 좌표가 문자 경계 상자 밖에 있습니다.
- GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT -- 지점의 화면 좌표가 문자 경계 상자 밖에 있기 때문에 기본 동작이 발생합니다.
- GXFPF_NEAREST-- 앵커 오프셋 = 1 -- 점의 화면 좌표에 가장 가까운 문자 위치는 문자 위치 1입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | textstor.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |