Share via

Функция SetConsoleActiveScreenBuffer

  • Статья

Важно!

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

Задает указанный буфер экрана для текущего отображаемого буфера экрана консоли.

Синтаксис

BOOL WINAPI SetConsoleActiveScreenBuffer(
  _In_ HANDLE hConsoleOutput
);

Параметры

hConsoleOutput [ввод]
Дескриптор буфера экрана консоли.

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

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

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

Замечания

Консоль может иметь несколько буферов экрана. SetConsoleActiveScreenBuffer определяет, какой из них отображается. Вы можете записать в неактивный буфер экрана, а затем использовать SetConsoleActiveScreenBuffer для отображения содержимого буфера.

Совет

Этот API не рекомендуется, но он имеет приблизительный виртуальный терминал эквивалент в альтернативной последовательности буфера экрана. Настройка альтернативного буфера экрана может предоставить приложению отдельное изолированное пространство для рисования в течение среды выполнения сеанса при сохранении содержимого, отображаемого вызывающим объектом приложения. Это сохраняет, что рисование сведений для простого восстановления при выходе процесса.

Примеры

Пример см. в разделе "Чтение и запись блоков символов и атрибутов".

Requirements

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхний колонтитул ConsoleApi2.h (через WinCon.h, включая Windows.h)
Библиотека Kernel32.lib
DLL-библиотеки Kernel32.dll

См. также

Функции консоли

Буферы экрана консоли

CreateConsoleScreenBuffer