SetCaretPos 함수(winuser.h)

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

구문

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

[in] X

형식: int

caret의 새 x 좌표입니다.

[in] Y

형식: int

케어의 새로운 y 좌표입니다.

형식: BOOL

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

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

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

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

이 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 도입)