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

ITfContextOwner::GetACPFromPoint 메서드는 화면 좌표의 점을 애플리케이션 문자 위치로 변환합니다.

구문

HRESULT GetACPFromPoint(
  [in]  const POINT *ptScreen,
  [in]  DWORD       dwFlags,
  [out] LONG        *pacp
);

매개 변수

[in] ptScreen

점의 화면 좌표가 있는 POINT 구조체에 대한 포인터입니다.

[in] dwFlags

문자 경계 상자를 기준으로 점의 화면 좌표를 기반으로 반환할 문자 위치를 지정합니다. 기본적으로 반환되는 문자 위치는 점의 화면 좌표를 포함하는 문자 경계 상자입니다. 점이 문자의 경계 상자 밖에 있으면 메서드는 NULL 또는 TF_E_INVALIDPOINT 반환합니다.

이 매개 변수에 대해 GXFPF_ROUND_NEAREST 플래그를 지정하고 점의 화면 좌표가 문자 경계 상자에 포함된 경우 반환되는 문자 위치는 점의 화면 좌표에 가장 가까운 경계 가장자리입니다.

이 매개 변수에 대해 GXFPF_NEAREST 플래그를 지정하고 점의 화면 좌표가 문자 경계 상자에 포함되지 않으면 가장 가까운 문자 위치가 반환됩니다.

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

[out] pacp

점의 화면 좌표에 해당하는 문자 위치를 받습니다.

반환 값

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

설명

점 1

• 기본값-- pacp = 0 --점의 화면 좌표는 문자 위치 0의 문자 경계 상자 내에 있습니다.
• GXFPF_ROUND_NEAREST-- pacp = 1 -- 점의 화면 좌표는 문자 위치 1의 시작 범위 위치인 범위 위치 1에 가장 가깝습니다.
• GXFPF_NEAREST-- pacp = 0 -- 포인트가 문자 위치 0의 문자 경계 상자 내에 있기 때문에 기본 동작이 발생합니다.

• 기본값-- hr = TF_E_INVALIDPOINT -- 점의 화면 좌표가 문자 경계 상자 밖에 있습니다.
• GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT -- 지점의 화면 좌표가 문자 경계 상자 밖에 있기 때문에 기본 동작이 발생합니다.
• GXFPF_NEAREST-- pacp = 1 -- 점의 화면 좌표에 가장 가까운 문자 위치는 문자 위치 1입니다.

요구 사항

추가 정보

ITextStoreACP::GetACPFromPoint

ITfContextOwner

ITfContextView::GetRangeFromPoint

TsViewCookie