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.