wingdi.h


CreateHalftonePalette

La función CreateHalftonePalette crea una paleta de medios tonos (halftone) para el contexto de dispositivo especificado.

Sintaxis

HPALETTE CreateHalftonePalette(
    HDC hdc  // manipulador de contexto de dispositivo
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno identifica a una paleta lógica de medios tonos.

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

Observaciones

Una aplicación debe crear una paleta de medios tonos cuando como modo de estrechamiento de un contexto de dispositivo se usa HALFTONE. La paleta de medios tonos devuelta por CreateHalftonePalette debe ser seleccionada y activada dentro del contexto de dispositivo antes de llamar a las funciones StretchBlt o StretchDIBits.

Cuando no se necesite más la paleta, llamar a la función DeleteObject para eliminarla.