wingdi.h


CreateHatchBrush

Crea un pincel lógico con el color y patrón de rallado especificado.

Sintaxis

HBRUSH CreateHatchBrush(
    int  fnStyle,     // estilo de rallado
    COLORREF  clrref  // valor de color
   );

Parámetros:

fnStyle: Especifica el estilo de rallado del pincel. Este parámetro puede tomar uno de los siguientes valores:

Valor Significado
HS_BDIAGONAL Trama de líneas diagonales a 45º descendentes de izquierda a derecha.
HS_CROSS Trama de líneas horizontales y verticales.
HS_DIAGCROSS Trama de líneas diagonales a 45º cruzadas.
HS_FDIAGONAL Trama de líneas diagonales a 45º ascendentes de izquierda a derecha.
HS_HORIZONTAL Trama de líneas horizontales.
HS_VERTICAL Trama de líneas verticales.

clrref: especifica el color que se usará para el rallado.

Valor de retorno

Si la función tiene éxito, el valor de retorno es un manipulador que identifica al pincel.

Si la función falla, el valor de retorno es NULL.

Observaciones

Un pincel rallado es un mapa de bits que Windows usa para pintar el interior de figuras cerradas.

Después de que una aplicación crea un pincel rallado, puede seleccionarlo para un contexto de dispositivo llamando a la función SelectObject.

Si una aplicación usa un pincel rallado para rellenar los fondos de una ventana y de una ventana hija y es necesario que las tramas coincidan, será necesario fijar el origen de del pincel antes de pintar el fondo de la ventana hija. Esto se puede hacer llamando a la función SetBrushOrgEx. El valor actual de este origen de puede recuperar con la función GetBrushOrgEx.

Cuando el pincel no se necesite más, hay que llamar a la función DeleteObject para borrarlo.