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

아티클
08/26/2023

텍스트 서비스 개체에 커서를 설정하도록 알립니다.

구문

HRESULT OnTxSetCursor(
  [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
);

매개 변수

[in] dwDrawAspect

형식: DWORD

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

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

값

의미

DVASPECT_CONTENT

텍스트 콘텐츠의 화면 이미지를 hdcDraw 디바이스 컨텍스트로 렌더링합니다. hicTargetDev 및 ptd 매개 변수는 대상 디바이스 컨텍스트(일반적으로 프린터)에 대한 정보를 제공합니다.

DVASPECT_DOCPRINT

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

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

lindex

형식: LONG

지원되지 않습니다.

[in] pvAspect

형식: void*

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

[in] ptd

형식: DVTARGETDEVICE*

대상 디바이스입니다.

[in] hdcDraw

형식: HDC

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

[in] hicTargetDev

형식: HDC

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

[in] lprcClient

형식: LPCRECT

컨트롤의 클라이언트 사각형입니다. 사각형의 좌표는 포함된 창의 클라이언트 좌표에 있습니다. NULL 은 법적 가치입니다.

[in] x

형식: INT

포함하는 창의 클라이언트 좌표에 있는 커서의 x 위치입니다.

[in] y

형식: INT

포함된 창의 클라이언트 좌표에서 커서의 y 위치입니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 S_OK.

메서드가 실패하면 반환 값은 다음 HRESULT 코드입니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
E_INVALIDARG	하나 이상의 잘못된 매개 변수입니다.

설명

text services 개체는 올바른 커서를 확인하기 위해 이 호출의 결과로 다시 해결할 수 있습니다. 올바른 커서는 TxSetCursor를 통해 설정됩니다.

lprcClient 매개 변수는 마우스 커서가 배치되는 컨트롤 보기의 클라이언트 사각형입니다. lprcClient 매개 변수는 WM_SIZE 메시지와 동일한 방식으로 포함된 창의 디바이스 좌표에 있습니다. 마지막으로 렌더링된 뷰가 아닐 수 있습니다. 또한 컨트롤이 현재 활성 상태인 경우 현재 활성 보기가 아닐 수 있습니다. 따라서 text services 개체는 현재 캐시 값에 대해 이 사각형을 검사 줄 다시 계산이 필요한지 여부를 결정해야 합니다. 확대/축소 계수는 이 계산에 포함되어야 합니다. 확대/축소 비율에 대한 자세한 내용은 TxGetExtent를 참조하세요.

이 메서드는 컨트롤의 화면 보기에 대해서만 호출해야 합니다. 따라서 디바이스 컨텍스트(DC)는 전달되지 않지만 화면 DC로 간주되어야 합니다.

자세한 내용은 ITextServices::TxDraw의 비고를 참조하세요.

요구 사항

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