Функция SetCaretPos перемещает каретку в заданные координаты. Если окно, которое владеет кареткой, создавалось со стилем класса CS_OWNDC, тогда устанавливаемые координаты подчиняются режиму отображения контекста устройства, связанного с этим окном.
Синтаксис
BOOL SetCaretPos( int X, int Y ); |
Параметры
X
[in] Определяет новую x-координату каретки.Y
[in] Определяет новую y-координату каретки.Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.
Замечания
Функция SetCaretPos перемещает каретку в любом случае скрыта она или нет.
Система предусматривает одну каретку на очередь. Окно должно создавать каретку только тогда, когда оно имеет фокус клавиатуры или активно. Окно должно уничтожить каретку перед потерей фокуса клавиатуры или перехода в не активный режим. Окно может установить позицию каретки только в том случае, если оно владеет кареткой.
Пример
Пример смотри в статье Создание и показ на экране каретки.
Смотри также
Обзор Каретки, GetCaretPos, HideCaret, ShowCaret
Размещение и совместимость SetCaretPos |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |