Функция SetConsoleCursorPosition
Функция
SetConsoleCursorPosition устанавливает позицию курсора в заданном экранном буфере консоли.Синтаксис
|
BOOL SetConsoleCursorPosition( 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 |
Нет |
|
Замечания по платформе |
Не имеется |