Función PatBlt (wingdi.h)

  • Artículo

La función PatBlt pinta el rectángulo especificado con el pincel seleccionado actualmente en el contexto de dispositivo especificado. El color del pincel y el color o los colores de la superficie se combinan mediante la operación ráster especificada.

Sintaxis

BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] x

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo que se va a rellenar.

[in] y

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo que se va a rellenar.

[in] w

Ancho, en unidades lógicas, del rectángulo.

[in] h

Alto, en unidades lógicas, del rectángulo.

[in] rop

Código de operación de trama. Este código puede ser uno de los siguientes valores.

Value 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 del rectángulo de destino mediante el operador XOR booleano.
DSTINVERT
 Invierte el rectángulo de destino.
OSCURIDAD
 Rellena el rectángulo de destino con el color asociado al índice 0 de la paleta física. (este color es negro para la paleta física predeterminada).
BLANCURA
 Rellena el rectángulo de destino mediante el color asociado al índice 1 de la paleta física. (este color es blanco para la paleta física predeterminada).

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Los valores del parámetro dwRop para esta función son un subconjunto limitado de los códigos de operación ternarios completos de 256; en concreto, no se puede usar un código de operación que hace referencia a un rectángulo de origen.

No todos los dispositivos admiten la función PatBlt . Para obtener más información, vea la descripción de la funcionalidad RC_BITBLT en la función GetDeviceCaps .

Ejemplos

Para obtener un ejemplo, vea "Ejemplo de Menu-Item mapas de bits" en Uso de menús.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

Funciones de pincel

Información general sobre los pinceles

GetDeviceCaps