Функция SetConsoleCursorPosition

Функция SetConsoleCursorPosition устанавливает позицию курсора в заданном экранном буфере консоли.

Синтаксис

BOOL SetConsoleCursorPosition(

HANDLE hConsoleOutput, // дескриптор экранного буфера
COORD
dwCursorPosition // координаты нового курсора

);

Параметры

hConsoleOutput

[in] Дескриптор экранного буфера консоли. Дескриптор должен иметь право доступа GENERIC_READ. Для получения дополнительной информации, см. статью Защита буфера и права доступа в консоли.

dwCursorPosition

[in] Структура COORD, которая устанавливает новую позицию курсора. Координаты - столбец и ряд символьного знакоместа экранного буфера. Координаты должны быть в пределах границ экранного буфера консоли.

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

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

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите функцию GetLastError.

Замечания

Позиция курсора обуславливает, где показаны на экране символы, написанные функцией WriteFile или WriteConsole, или повторенные в эхо режиме функцией ReadFile или ReadConsole. Чтобы выяснить текущую позицию курсора, используйте функцию GetConsoleScreenBufferInfo.

Если новая позиция курсора не в пределах границ окна экранного буфера консоли, начало координат окна изменяется, чтобы сделать курсор видимым.

Код примера

Пример смотри в статье Чтение и запись блоков символов и атрибутов.

Смотри также

Обзор консольных приложений, Функции консоли, GetConsoleCursorInfo, GetConsoleScreenBufferInfo, ReadConsole, ReadFile, SetConsoleCursorInfo, WriteConsole, WriteFile

Размещение и совместимость SetConsoleCursorPosition

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Импортируемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz