wingdi.h


PatBlt

La función PatBlt pinta el rectángulo dado usando el pincel actualmente seleccionado en el contexto de dispositivo especificado. El color del pincel y el color o colores de la superficie se combinan usando la operación de rastreo dada.

Sintaxis

BOOL PatBlt(
    HDC hdc,      // manipulador de contexto de dispositivo
    int nXLeft,   // coordenada x de la esquina superior izquierda del rectángulo a rellenar
    int nYLeft,   // coordenada y de la esquina superior izquierda del rectángulo a rellenar
    int nWidth,   // anchura del rectángulo a rellenar
    int nHeight,  // altura del rectángulo a rellenar
    DWORD dwRop   // código de operación de rastreo
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

nXLeft: especifica la coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo a rellenar.

nYLeft: especifica la coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo a rellenar.

nWidth: especifica la anchura, en unidades lógicas, del rectángulo.

nHeight: especifica la altura, en unidades lógicas, del rectángulo.

dwRop: especifica el código de operación de rastreo. Este código puede ser uno de los siguientes valores:

Valor Significado
PATCOPY Copia el patrón especificado en el mapa de bits de destino.
PATINVERT Combina los colores del patrón especificado con los colores en el rectángulo destino usando el operador boolenao XOR.
DSTINVERT Invierte el rectángulo de destino.
BLACKNESS Rellena el rectángulo de destino usando el color asociado al índice 0 de la paleta física. (Este color es negro para la paleta física por defecto.)
WHITENESS Rellena el rectángulo de destino usando el color asociado al índice 1 de la paleta física. (Este color es blanco para la paleta física por defecto.)

Valor de retorno

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

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

Observaciones

Los valores del parámetro dwRop para esta función están limitados a un subconjunto del los 256 código ternarios posible de operaciones de rastreo; en particular, no puede usarse ningún código de operación que implique un rectángulo de origen.

No todos los dispositivos soportan la función PatBlt. Para mayor información, ver la descripción de la capacidad de rastreo RC_BITBLT en la función GetDeviceCaps.