SetCaretPos 함수(winuser.h)

지정된 좌표로 캐리트를 이동합니다. CS_OWNDC 클래스 스타일을 사용하여 캐리트를 소유하는 창을 만든 경우 지정된 좌표는 해당 창과 연결된 디바이스 컨텍스트의 매핑 모드가 적용됩니다.

구문

BOOL SetCaretPos(
  [in] int X,
  [in] int Y
);

매개 변수

[in] X

형식: int

케어의 새 x 좌표입니다.

[in] Y

형식: int

캐리트의 새 y 좌표입니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

SetCaretPos는 캐리트가 숨겨져 있는지 여부를캐럿을 이동합니다.

시스템은 큐당 하나의 케어를 제공합니다. 창은 키보드 포커스가 있거나 활성 상태인 경우에만 캐리트를 만들어야 합니다. 키보드 포커스를 잃거나 비활성 상태가 되기 전에 창에서 캐리트를 삭제해야 합니다. 창은 캐럿을 소유하는 경우에만 캐럿 위치를 설정할 수 있습니다.

DPI 가상화

이 API는 DPI 가상화에 참여하지 않습니다. 제공된 위치는 캐리트와 연결된 창 측면에서 논리적 좌표로 해석됩니다. 호출 스레드는 고려되지 않습니다.

예제

예제는 Caret 만들기 및 표시를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-caret-l1-1-0(Windows 8 도입)

참고 항목

캐럿

개념

GetCaretPos

HideCaret

참조

ShowCaret