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

애플리케이션은 레이아웃 상자의 왼쪽 위 위치를 기준으로 특정 픽셀 위치를 전달하는 이 함수를 호출하고 적중 테스트가 발생한 텍스트 문자열의 특파원 적중 테스트 메트릭에 대한 정보를 가져옵니다. 지정된 픽셀 위치가 텍스트 문자열 외부에 있으면 함수는 출력 값 *isInside 를 FALSE로 설정합니다.

구문

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

매개 변수

pointX

형식: FLOAT

레이아웃 상자의 왼쪽 위 위치를 기준으로 적중 테스트할 픽셀 위치 X입니다.

pointY

형식: FLOAT

레이아웃 상자의 왼쪽 위 위치를 기준으로 적중 테스트할 픽셀 위치 Y입니다.

[out] isTrailingHit

형식: BOOL*

적중 테스트 위치가 문자의 선행 또는 후행 쪽에 있는지 여부를 나타내는 출력 플래그입니다. 출력 *isInside 값이 FALSE로 설정되면 이 값은 hitTestMetrics-textPosition> 출력에 따라 설정되어 적중 테스트 위치에 가장 가까운 가장자리를 나타냅니다.

[out] isInside

형식: BOOL*

적중 테스트 위치가 텍스트 문자열 내에 있는지 여부를 나타내는 출력 플래그입니다. FALSE이면 텍스트 가장자리와 가장 가까운 위치가 반환됩니다.

[out] hitTestMetrics

형식: DWRITE_HIT_TEST_METRICS*

적중 테스트 위치를 완전히 둘러싸는 출력 기하 도형입니다. 출력 *isInside 값이 FALSE로 설정된 경우 이 구조체는 적중 테스트 위치에 가장 가까운 가장자리를 둘러싸는 기하 도형을 나타냅니다.

반환 값

형식: HRESULT

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteTextLayout