HatchBrush Class

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Package:

System.Drawing.Common v9.0.0-rc.2.24474.1

Source:

HatchBrush.cs

Defines a rectangular brush with a hatch style, a foreground color, and a background color. This class cannot be inherited.

public ref class HatchBrush sealed : System::Drawing::Brush

public sealed class HatchBrush : System.Drawing.Brush

type HatchBrush = class
    inherit Brush

Public NotInheritable Class HatchBrush
Inherits Brush

Inheritance

Object

MarshalByRefObject

Brush

HatchBrush

Examples

The following example shows how to create the HatchBrush shown in the previous illustration.

HatchBrush hBrush = new HatchBrush(
   HatchStyle.Horizontal,
   Color.Red,
   Color.FromArgb(255, 128, 255, 255));
e.Graphics.FillEllipse(hBrush, 0, 0, 100, 60);

Dim hBrush As New HatchBrush( _
   HatchStyle.Horizontal, _
   Color.Red, _
   Color.FromArgb(255, 128, 255, 255))
e.Graphics.FillEllipse(hBrush, 0, 0, 100, 60)

Remarks

A hatch pattern is made from two colors: one defined by the BackgroundColor, which fills the background and one for the lines that form the pattern over the background defined by the ForegroundColor property. The HatchStyle property defines what type of pattern the brush has and can be any value from the HatchStyle enumeration. There are more than fifty elements in the HatchStyle enumeration.

The following illustration shows an ellipse filled with a horizontal hatch pattern.

Note

In .NET 6 and later versions, the System.Drawing.Common package, which includes this type, is only supported on Windows operating systems. Use of this type in cross-platform apps causes compile-time warnings and run-time exceptions. For more information, see System.Drawing.Common only supported on Windows.

Constructors

HatchBrush(HatchStyle, Color)	Initializes a new instance of the HatchBrush class with the specified HatchStyle enumeration and foreground color.
HatchBrush(HatchStyle, Color, Color)	Initializes a new instance of the HatchBrush class with the specified HatchStyle enumeration, foreground color, and background color.

Properties

BackgroundColor	Gets the color of spaces between the hatch lines drawn by this HatchBrush object.
ForegroundColor	Gets the color of hatch lines drawn by this HatchBrush object.
HatchStyle	Gets the hatch style of this HatchBrush object.

Methods

Clone()	Creates an exact copy of this HatchBrush object.
CreateObjRef(Type)	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject)
Dispose()	Releases all resources used by this Brush object. (Inherited from Brush)
Dispose(Boolean)	Releases the unmanaged resources used by the Brush and optionally releases the managed resources. (Inherited from Brush)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetLifetimeService()	Obsolete. Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject)
GetType()	Gets the Type of the current instance. (Inherited from Object)
InitializeLifetimeService()	Obsolete. Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject)
SetNativeBrush(IntPtr)	In a derived class, sets a reference to a GDI+ brush object. (Inherited from Brush)
ToString()	Returns a string that represents the current object. (Inherited from Object)