LpConsoleScreenBufferInfo

Функция GetStdHandle

Функция GetStdHandle извлекает дескриптор для стандартного ввода данных, стандартного вывода или стандартной ошибки устройства.

Синтаксис

HANDLE GetStdHandle( DWORD nStdHandle // ввод, вывод или ошибка устройства );

Параметры

NStdHandle

[in] Стандартное устройство, для которого дескриптор должен быть возвращен. Этот параметр может быть одним из следующих значений.

Именованная константа	Предназначение
STD_INPUT_HANDLE	Дескриптор стандартного устройства ввода данных. Вначале, это - дескриптор консольного буфера ввода, CONIN$.
STD_OUTPUT_HANDLE	Дескриптор устройства стандартного вывода. Вначале, это - дескриптор активного экранного буфера консоли, CONOUT$.
STD_ERROR_HANDLE	Дескриптор стандартной ошибки устройства. Вначале, это - дескриптор активного экранного буфера консоли, CONOUT$.

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

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

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

Замечания

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

Функция SetConsoleTextAttribute

Функция SetConsoleTextAttribute устанавливает атрибуты символов, записанных в экранный буфер консоли функцией WriteFile или WriteConsole, или повторенных в эхо режиме функцией ReadFile или ReadConsole. Эта функция воздействует на текст, записанный после вызова функции.

Синтаксис

BOOL SetConsoleTextAttribute( HANDLE hConsoleOutput,// дескриптор экранного буфера WORD wAttributes // цвет текста и фона );

Параметры

HConsoleOutput

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

WAttributes

[in] Смотри Атрибуты символа.

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

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

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

Замечания

Чтобы выяснять текущие атрибуты цвета экранного буфера, вызовите функцию GetConsoleScreenBufferInfo.

Функция GetConsoleCursorInfo

Declare Function GetConsoleCursorInfo Lib "kernel32" (ByVal hConsoleOutput As Long, _ lpConsoleCursorInfo As CONSOLE_CURSOR_INFO) As Long

GetConsoleCursorInfo получает размер и видимость курсора в заданной консоли.

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

В случае ошибки функция возвращает 0 (используйте GetLastError для получения кода ошибки). В успешном случае возвращается ненулевое значение

Параметры

hConsoleOutput

Описатель консоли

lpConsoleCursorInfo

Структура CONSOLE_CURSOR_INFO, получающая информацию о курсоре

Структура CONSOLE_CURSOR_INFO

Type CONSOLE_CURSOR_INFO dwSize As LongbVisible As LongEnd Type

Структура CONSOLE_CURSOR_INFO содержит информацию о курсоре консоли.

Состав структуры

dwSize

Процентное отношение от символьного знакоместа, которое заполнено курсором. Это значение находится между 1 и 100. Внешний вид курсора меняется в пределах от полностью заполненной ячейки до показа как горизонтальной линии внизу ячейки

bVisible

Видимость курсора. Если курсор видим, параметр равен TRUE

SetConsoleCursorPosition

SetConsoleCursorPosition(handle, coord)

Структура COORD определяет координаты ячейки символа в консольном буфере экрана. Начало системы координат (0,0) - левая верхняя ячейка экранного буфера.

typedef struct _COORD {

SHORTX;

SHORTY;

} COORD;

Элементы

X Горизонтальная координата или значение столбца.

Y Вертикальная координата или значение ряда.

Функция 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 содержит информацию об экранном буфере консоли.

Синтаксис

typedef struct _CONSOLE_SCREEN_BUFFER_INFO {COORD dwSize;COORD dwCursorPosition;WORD wAttributes;SMALL_RECT srWindow;COORD dwMaximumWindowSize;} CONSOLE_SCREEN_BUFFER_INFO;

Члены структуры

DwSize

Структура COORD, которая содержит размер экранного буфера консоли, в столбцах и рядах символов.

DwCursorPosition

Структура COORD, которая содержит координаты столбца и ряда курсора в экранном буфере консоли.

WAttributes

Атрибуты символов, записанных в экранный буфер функциями WriteFile и WriteConsole, или повторенных в экранном буфере функциями ReadFile и ReadConsole. Для получения дополнительной информации, см. статью Атрибуты символа.

SrWindow

Структура SMALL_RECT, которая содержит координаты левого верхнего и нижнего правого углов окна экранного буфера консоли на экране дисплея.

DwMaximumWindowSize

Структура COORD, которая содержит максимальный размер консольного окна, с учетом текущего размера экранного буфера и шрифта и размера экрана.