Función SetConsoleActiveScreenBuffer

  • Artículo

Importante

En este documento se describe funcionalidad de la plataforma de consola que ya no forma parte de nuestro plan de desarrollo del ecosistema. No se recomienda usar este contenido en nuevos productos, pero seguiremos admitiendo los usos existentes en un futuro indefinido. Nuestra solución moderna preferida se centra en secuencias de terminal virtual para lograr la máxima compatibilidad en escenarios multiplataforma. Puede encontrar más información sobre esta decisión de diseño en nuestro documento de Comparación de consola clásica y terminal virtual.

Establece el búfer de pantalla especificado como el búfer de pantalla de consola que se muestra actualmente.

Sintaxis

BOOL WINAPI SetConsoleActiveScreenBuffer(
  _In_ HANDLE hConsoleOutput
);

Parámetros

hConsoleOutput [in]
Identificador del búfer de pantalla de la consola.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Una consola puede tener varios búferes de pantalla. SetConsoleActiveScreenBuffer determina cuál se muestra. Puede escribir en un búfer de pantalla inactivo y, a continuación, mostrar su contenido con SetConsoleActiveScreenBuffer.

Sugerencia

Esta API no se recomienda, pero tiene un terminal virtual aproximado equivalente en la secuencia del búfer de pantalla alternativo. Establecer el búfer de pantalla alternativo puede proporcionar a una aplicación un espacio aislado independiente para dibujar durante el tiempo de ejecución de la sesión y conservar al mismo tiempo el contenido que se mostraba desde el invocador de la aplicación. Así se conserva la información de dibujo para realizar una restauración simple en la salida del proceso.

Ejemplos

Para ver un ejemplo, consulte Lectura y escritura de bloques de caracteres y atributos.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado ConsoleApi2.h (a través de WinCon.h, incluido Windows.h)
Biblioteca Kernel32.lib
Archivo DLL Kernel32.dll

Consulte también

Funciones de la consola

Búferes de pantalla de la consola

CreateConsoleScreenBuffer