Функция SetConsoleCursorInfo

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

Синтаксис

BOOL SetConsoleCursorInfo(

HANDLE hConsoleOutput,                          // дескриптор экран. буфера
CONST CONSOLE_CURSOR_INFO
* lpConsoleCursorInfo // информация о курсоре

);

Параметры

hConsoleOutput

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

lpConsoleCursorInfo

[in] Указатель на структуру CONSOLE_CURSOR_INFO, которая обеспечивает новую спецификацию для курсора экранного буфера консоли.

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

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

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

Замечания

Когда курсор экранного буфера видим, его внешний вид может изменяться в пределах от полностью заполненного символьного знакоместа до показа как горизонтальной линии внизу ячейки. Член dwSize структуры CONSOLE_CURSOR_INFO устанавливает процентное отношение от символьного знакоместа, которое заполняется курсором. Если этот член меньше чем 1 или больший чем 100, функция SetConsoleCursorInfo терпит неудачу.

Смотри также

Обзор консольных приложений, Функции консоли, CONSOLE_CURSOR_INFO, GetConsoleCursorInfo, SetConsoleCursorPosition

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

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

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки
Перевод 05.01.2003 15:43 ©Copyright V. Sokovikov
Hosted by uCoz