wincon.h


SetConsoleTextAttribute

La función SetConsoleTextAttribute asigna los atributos de color para el primer plano (texto) y el fondo de los caracteres escritos al buffer de pantalla por WriteFile o WriteConsole, o el eco de la función ReadFile o ReadConsole. Esta función afecta sólo al texto escrito después de la llamada a la función.

Sintaxis

BOOL SetConsoleTextAttribute(
    HANDLE hConsoleOutput,  // manipulador de buffer de pantalla de consola
    WORD wAttributes        // colores de texto y fondo
   );

Parámetros

hConsoleOutput
Identifica un buffer de pantalla de consila. El manipulador debe tener acceso GENERIC_READ.
wAttributes
Especifica los atributos de primer plano y fondo. Se puede especificar cualquier combinación de los siguientes valores: FOREGROUND_BLUE, FOREGROUND_GREEN, FOREGROUND_RED, FOREGROUND_INTENSITY, BACKGROUND_BLUE, BACKGROUND_GREEN, BACKGROUND_RED y BACKGROUND_INTENSITY. Por ejemplo, la siguiente combinación de valores produce texto blanco sobre fondo negro:
FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE  

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para optener información adicional sobre el error, llamar a GetLastError.

Observaciones

Para determinar los atributos de color actuales del buffer de pantalla, llamar a la función GetConsoleScreenBufferInfo.