wingdi.h


SetTextColor

La función SetTextColor asigna el color indicado para el texto y para un contexto de dispositivo especificados.

Sintaxis

COLORREF SetTextColor(
    HDC  hdc,         // manipulador de contexto de dispositivo
    COLORREF  crColor // color de texto
   );

Parámetros

hdc: identifica el contexto de dispositivo.

crColor: especifica el color del texto.

Valor de retorno

Si la función tiene éxito, el valor de retorno es una referecia de color para el color previo del texto.

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

Observaciones

El color del texto se usa para trazar cada carácter escrito por las funciones TextOut y ExtTextOut. El color de texto también se usa para convertir mapas de bits de color a monocromo y viceversa.