wingdi.h


SetBkMode

Selecciona el modo de mezcla para el fondo para el contexto de dispositivo especificado. El modo de mezcla de fondo se usa con texto, pinceles con tramas y estilos de pluma que no sean líneas sólidas.

Sintaxis

int SetBkMode(
    HDC hdc,    // manipulador de contexto de dispositivo
    int iBkMode // especifica el modo de fondo
   );

Parámetros:

hdc: identificador de contexto de dispositivo.

iBkMode: especifica el modo de fondo. Este parámetro puede tomar cualquiera de los siguientes valores:

Valor Descripción
OPAQUE El fondo se rellena con el valor actual del color de fondo antes de mostrar el texto, el pincel con trama o la pluma.
TRANSPARENT El fondo permanece sin alterar.

Valor de retorno

Si la función tiene éxito, el valor de retorno es valor previo del modo de fondo.

Si la función falla, el valor de retorno es cero.

Observaciones

El valor actual del color del fondo se puede cambiar con la función SetBkColor.

Afecta a los estilos de línea para líneas trazadas usando una pluma creada con CreatePen. SetBkMode no afecta a líneas trazadas usando una pluma creada con ExtCreatePen.

El parámetro iBkMode puede tomar valores específicos de driver. GDI pasa esos valores al driver del dispositivo y en cualquier otro caso los ignora.