IDirect3DDevice9::SetCursorPosition 메서드(d3d9helper.h)

아티클
08/23/2023

커서 위치 및 업데이트 옵션을 설정합니다.

구문

void SetCursorPosition(
  [in] int   X,
  [in] int   Y,
  [in] DWORD Flags
);

매개 변수

[in] X

형식: INT

가상 데스크톱 좌표에서 커서의 새 X 위치입니다. 설명 부분을 참조하세요.

[in] Y

형식: INT

가상 데스크톱 좌표에서 커서의 새 Y 위치입니다. 설명 부분을 참조하세요.

[in] Flags

형식: DWORD

커서에 대한 업데이트 옵션을 지정합니다. 현재는 하나의 플래그만 정의됩니다.

값	의미
D3DCURSOR_IMMEDIATE_UPDATE	새로 고침 속도로 커서를 업데이트합니다. 이 플래그를 지정하면 시스템은 커서가 디스플레이 새로 고침 속도의 절반 이상으로 업데이트되지만 디스플레이 새로 고침 빈도보다 더 자주 업데이트되지 않도록 보장합니다. 그렇지 않으면 메서드는 다음 IDirect3DDevice9::P resent 호출까지 커서 업데이트를 지연합니다. 이 플래그를 설정하지 않으면 일반적으로 플래그가 설정된 경우보다 성능이 향상됩니다. 그러나 Present에 대한 호출 속도가 충분히 낮으면 사용자가 커서 동작에 상당한 지연을 발견할 수 있을 정도로 애플리케이션에서 이 플래그를 설정해야 합니다. 이 플래그는 창 모드 애플리케이션에 영향을 주지 않습니다. 일부 비디오 카드는 하드웨어 색 커서를 구현합니다. 이 플래그는 이러한 카드에 영향을 주지 않습니다.

값

의미

D3DCURSOR_IMMEDIATE_UPDATE

새로 고침 속도로 커서를 업데이트합니다.

이 플래그를 지정하면 시스템은 커서가 디스플레이 새로 고침 속도의 절반 이상으로 업데이트되지만 디스플레이 새로 고침 빈도보다 더 자주 업데이트되지 않도록 보장합니다. 그렇지 않으면 메서드는 다음 IDirect3DDevice9::P resent 호출까지 커서 업데이트를 지연합니다. 이 플래그를 설정하지 않으면 일반적으로 플래그가 설정된 경우보다 성능이 향상됩니다. 그러나 Present에 대한 호출 속도가 충분히 낮으면 사용자가 커서 동작에 상당한 지연을 발견할 수 있을 정도로 애플리케이션에서 이 플래그를 설정해야 합니다. 이 플래그는 창 모드 애플리케이션에 영향을 주지 않습니다. 일부 비디오 카드는 하드웨어 색 커서를 구현합니다. 이 플래그는 이러한 카드에 영향을 주지 않습니다.

반환 값

없음

설명

전체 화면 모드에서 실행하는 경우 화면 공간 좌표는 현재 디스플레이 모드로 적절하게 조정된 백 버퍼 좌표입니다. 창 모드에서 실행하는 경우 화면 공간 좌표는 바탕 화면 좌표입니다. 커서 이미지는 SetCursorProperties 메서드에서 지정한 핫스팟 오프셋을 뺀 지정된 위치에 그려집니다.

ShowCursor에서 커서를 숨기면 커서가 그려지지 않습니다.