Función DrawDibBegin (vfw.h)
La función DrawDib cambia los parámetros de un controlador de dominio DrawDib o inicializa un nuevo drawDib DC.
Sintaxis
BOOL VFWAPI DrawDibBegin(
HDRAWDIB hdd,
HDC hdc,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int dxSrc,
int dySrc,
UINT wFlags
);
Parámetros
hdd
Identificador de un controlador DrawDib.
hdc
Identificador de un controlador de dominio para dibujar. Este parámetro es opcional.
dxDst
Ancho, en MM_TEXT unidades de cliente, del rectángulo de destino.
dyDst
Alto, en MM_TEXT unidades de cliente, del rectángulo de destino.
lpbi
Puntero a una estructura BITMAPINFOHEADER que contiene el formato de imagen. La tabla de colores de la DIB sigue el formato de imagen y el miembro biHeight debe ser un valor positivo.
dxSrc
Ancho, en píxeles, del rectángulo de origen.
dySrc
Alto, en píxeles, del rectángulo de origen.
wFlags
Marcas aplicables para la función. Se definen los valores siguientes.
| Valor | Significado |
|---|---|
| DDF_ANIMATE | Permite la animación de paleta. Si este valor está presente, DrawDib reserva tantas entradas como sea posible estableciendo PC_RESERVED en las entradas de matriz palPalEntry de la estructura LOGPALETTE y la paleta se puede animar mediante la función DrawDibChangePalette . Si la aplicación usa la función DrawDibBegin con la función DrawDibDraw , establezca este valor con DrawDibBegin en lugar de DrawDibDraw. |
| DDF_BACKGROUNDPAL | Se da cuenta de la paleta utilizada para dibujar como tarea en segundo plano, dejando la paleta actual utilizada para la presentación sin cambios. (Este valor es mutuamente excluyente de DDF_SAME_HDC). |
| DDF_BUFFER | Hace que DrawDib intente usar un búfer fuera de pantalla para que se pueda usar DDF_UPDATE. Esto deshabilita la descompresión y el dibujo directamente en la pantalla. Si DrawDib no puede crear un búfer fuera de pantalla, se descomprimirá o dibujará directamente en la pantalla. Para obtener más información, consulte los valores de DDF_UPDATE y DDF_DONTDRAW descritos para DrawDibDraw. |
| DDF_DONTDRAW | La imagen actual no se dibuja, pero está descomprimida. DDF_UPDATE se puede usar más adelante para dibujar la imagen. Esta marca sustituye a la marca DDF_PREROLL . |
| DDF_FULLSCREEN | No compatible. |
| DDF_HALFTONE | Siempre ancla la DIB a una paleta estándar, independientemente de la paleta de la DIB. Si la aplicación usa DrawDibBegin con DrawDibDraw, establezca este valor con DrawDibBegin en lugar de DrawDibDraw. |
| DDF_JUSTDRAWIT | Dibuja la imagen mediante GDI. Prohíbe a las funciones DrawDib descomprimir, estirar o separar la imagen. Esta tira DrawDib de funcionalidades que la diferencian de la función StretchDIBits . |
| DDF_SAME_DRAW | Use los parámetros de dibujo actuales para DrawDibDraw. Use este valor solo si lpbi, dxDest, dyDest, dxSrc y dySrc no han cambiado desde que se usa DrawDibDraw o DrawDibBegin. Esta marca reemplaza las marcas DDF_SAME_DIB y DDF_SAME_SIZE . |
| DDF_SAME_HDC | Use el identificador de controlador de dominio actual y la paleta asociadas actualmente al controlador de dominio. |
| DDF_UPDATE | El último mapa de bits almacenado en búfer debe volver a dibujarse. Si se produce un error en el dibujo con este valor, una imagen almacenada en búfer no está disponible y es necesario especificar una nueva imagen antes de que se pueda actualizar la pantalla. |
Valor devuelto
Devuelve TRUE si es correcto o FALSE en caso contrario.
Comentarios
Esta función se prepara para dibujar un DIB especificado por lpbi en el controlador de dominio. La imagen se ajusta al tamaño especificado por dxDest y dyDest. Si dxDest y dyDest se establecen en -1, la DIB se dibuja en una escala de 1:1 sin estirar.
Puede actualizar las marcas de un controlador de dominio DrawDib reeditando DrawDibBegin, especificando las nuevas marcas y cambiando al menos una de las siguientes opciones: dxDest, dyDest, lpbi, dxSrc o dySrc.
Si los parámetros de DrawDibBegin no han cambiado, las llamadas posteriores a la función no tienen ningún efecto.
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 | vfw.h |
| Library | Vfw32.lib |
| Archivo DLL | Msvfw32.dll |