Функция GetConsoleScreenBufferInfo


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

Синтаксис

BOOL GetConsoleScreenBufferInfo(
HANDLE hConsoleOutput,  // дескриптор экранного буфера
PCONSOLE_SCREEN_BUFFER_INFO lpConsoleScreenBufferInfo
                       // информация об экр. буфере
);

Параметры

hConsoleOutput

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

lpConsoleScreenBufferInfo

[out] Указатель на структуру CONSOLE_SCREEN_BUFFER_INFO, которая принимает информацию экранного буфера консоли

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

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

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

Замечания

Прямоугольник, возвращенный в члене srWindow структуры CONSOLE_SCREEN_BUFFER_INFO может быть изменен, а затем переправлен в функцию SetConsoleWindowInfo, чтобы прокрутить экранный буфер консоли в окне, изменить размер окна, или совершить оба действия вместе.

Все координаты, возвращенные в структуре CONSOLE_SCREEN_BUFFER_INFO находятся в координатах символьного знакоместа, начало координат которого (0, 0) в левом верхнем углу экранного буфера консоли.

Код примера

За примером обратитесь к статье Прокрутка окна экранного буфера.

Смотри также

Обзор консольных приложений, Функции консоли, CONSOLE_SCREEN_BUFFER_INFO, GetLargestConsoleWindowSize, SetConsoleCursorPosition, SetConsoleScreenBufferSize, SetConsoleWindowInfo

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

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