ITextServices::TxQueryHitPoint 메서드(textserv.h)

아티클
08/26/2023

지정된 점이 텍스트 서비스 개체의 사각형 내에 있는지 여부를 테스트합니다.

구문

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

매개 변수

[in] dwDrawAspect

형식: DWORD

그리기 측면은 다음 값 중 하나일 수 있습니다.

값	의미
DVASPECT_CONTENT	텍스트 콘텐츠의 화면 이미지를 hdcDraw 디바이스 컨텍스트로 렌더링합니다. hicTargetDev 및 ptd 매개 변수는 대상 디바이스 컨텍스트(일반적으로 프린터)에 대한 정보를 제공합니다.
DVASPECT_DOCPRINT	개체를 프린터에 인쇄된 것처럼 hdcDraw 디바이스 컨텍스트로 렌더링합니다. 따라서 text services 개체는 프린터에 최적화할 수 있습니다(예: 흰색인 경우 배경색을 그리지 않음). 또한 특정 화면별 요소(예: 선택 영역)를 렌더링해서는 안 됩니다. ITextServices::TxGetNaturalSize 는 현재 스크롤 위치에서 시작하여 lprcClient 사각형을 렌더링해야 합니다.

값

의미

DVASPECT_CONTENT

텍스트 콘텐츠의 화면 이미지를 hdcDraw 디바이스 컨텍스트로 렌더링합니다.

hicTargetDev 및 ptd 매개 변수는 대상 디바이스 컨텍스트(일반적으로 프린터)에 대한 정보를 제공합니다.

DVASPECT_DOCPRINT

개체를 프린터에 인쇄된 것처럼 hdcDraw 디바이스 컨텍스트로 렌더링합니다. 따라서 text services 개체는 프린터에 최적화할 수 있습니다(예: 흰색인 경우 배경색을 그리지 않음). 또한 특정 화면별 요소(예: 선택 영역)를 렌더링해서는 안 됩니다.

ITextServices::TxGetNaturalSize 는 현재 스크롤 위치에서 시작하여 lprcClient 사각형을 렌더링해야 합니다.

lindex

형식: LONG

지원되지 않습니다.

[in] pvAspect

형식: void*

그리기 최적화에 대한 정보입니다.

[in] ptd

형식: DVTARGETDEVICE*

대상 디바이스에 대한 정보입니다.

[in] hdcDraw

형식: HDC

디바이스 컨텍스트 렌더링.

[in] hicTargetDev

형식: HDC

대상 정보 컨텍스트입니다.

[in] lprcClient

형식: LPCRECT

적중 횟수 테스트가 수행되는 보기의 클라이언트(디바이스) 좌표에 있는 컨트롤의 클라이언트 사각형입니다.

[in] x

형식: INT

적중 횟수 테스트가 수행되는 보기의 클라이언트 좌표에서 검사 x 좌표입니다.

[in] y

형식: INT

적중 횟수 테스트가 수행되는 보기의 클라이언트 좌표에서 검사 y 좌표입니다.

[out] pHitResult

형식: DWORD*

적중 테스트의 결과입니다. 다음 TXTHITRESULT 열거형 값 중 어느 것이라도 될 수 있습니다.

값	의미
TXTHITRESULT_CLOSE	지점은 클라이언트 사각형에 있고 서로 다른 영역에 가깝습니다.
TXTHITRESULT_HIT	지점은 클라이언트 사각형에 있으며 텍스트 위에 있거나 배경이 투명하지 않습니다.
TXTHITRESULT_NOHIT	지점이 클라이언트 사각형 외부에 있습니다.
TXTHITRESULT_TRANSPARENT	지점은 클라이언트 사각형에 있고 텍스트를 넘지 않거나 배경이 투명했습니다.

반환 값

형식: HRESULT

반환 값은 HRESULT 코드입니다.

설명

이 메서드를 사용하면 호스트가 텍스트에 대한 투명한 적중 테스트를 구현할 수 있습니다.

자세한 내용은 ITextServices::TxDraw 및 ITextServices::OnTxSetCursor의 설명 섹션을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	textserv.h
DLL	Msftedit.dll