IDWriteTextLayout::HitTestTextPosition 메서드(dwrite.h)

애플리케이션은 텍스트 위치와 위치의 논리적 측면이 지정된 레이아웃 상자의 왼쪽 위를 기준으로 픽셀 위치를 가져오기 위해 이 함수를 호출합니다. 이 함수는 일반적으로 현재 텍스트 편집 위치에 해당하는 위치에서 캐리트가 그려지는 텍스트의 캐리트 위치 지정의 일부로 사용됩니다. UI 자동화에서 특정 텍스트 위치의 기하 도형을 프로그래밍 방식으로 가져오는 방법으로 사용할 수도 있습니다.

구문

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

매개 변수

textPosition

형식: UINT32

픽셀 위치를 가져오는 데 사용되는 텍스트 위치입니다.

isTrailingHit

형식: BOOL

픽셀 위치가 지정된 텍스트 위치의 선행 또는 후행 면인지 여부를 나타내는 부울 플래그입니다.

[out] pointX

형식: FLOAT*

이 메서드가 반환되면 레이아웃 상자의 왼쪽 위 위치를 기준으로 출력 픽셀 위치 X가 포함됩니다.

[out] pointY

형식: FLOAT*

이 메서드가 반환되면 레이아웃 상자의 왼쪽 위 위치를 기준으로 출력 픽셀 위치 Y가 포함됩니다.

[out] hitTestMetrics

형식: DWRITE_HIT_TEST_METRICS*

이 메서드가 반환될 때 지정된 텍스트 위치를 완전히 바깥쪽에 있는 출력 기하 도형을 포함합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

추가 정보

IDWriteTextLayout