Функция SetConsoleScreenBufferSize

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

Синтаксис

BOOL SetConsoleScreenBufferSize(

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

);

Параметры

hConsoleOutput

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

dwSize

[in] Структура COORD, которая устанавливает новый размер экранного буфера консоли, в рядах и столбцах. Заданная ширина и высота не могут быть меньше чем ширина и высота окна экранного буфера консоли. Заданные размеры также не могут быть меньше чем минимальный размер, разрешенный системой. Этот минимум зависит от текущего размера шрифта консоли (выбранного пользователем) и значений SM_CXMIN и SM_CYMIN, возвращенных функцией GetSystemMetrics.

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

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

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

Смотри также

Обзор консольных приложений, Функции консоли, COORD, GetConsoleScreenBufferInfo, SetConsoleWindowInfo

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

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