Функция SetCaretPos (winuser.h)

Статья
03/04/2024

Перемещает курсор на указанные координаты. Если окно, владеющее курсором, было создано со стилем класса CS_OWNDC , то указанные координаты подчиняются режиму сопоставления контекста устройства, связанного с этим окном.

Синтаксис

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

Параметры

[in] X

Тип: int

Новая координата курсора по оси X.

[in] Y

Тип: int

Новая координата курсора по оси Y.

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Система предоставляет по одному курсору на очередь. Окно должно создавать курсор только в том случае, если оно имеет фокус клавиатуры или активно. Окно должно уничтожить курсор, прежде чем потерять фокус клавиатуры или стать неактивным. Окно может задать положение курсора только в том случае, если оно владеет курсором.

Виртуализация DPI

Этот API не участвует в виртуализации DPI. Указанная позиция интерпретируется как логические координаты с точки зрения окна, связанного с курсором. Вызывающий поток не учитывается.

Примеры

Пример см. в разделе Создание и отображение курсора.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-caret-l1-1-0 (представлен в Windows 8)