backBrush

Type: Binary

Availability: Read or write at any time

The backBrush property of the Form class enables you to tile the background of the form with the bitmap when the property is set to a bitmap. Tiling means that as many copies of the bitmap as are required cover the entire visible form surface. (The process is the same as the Windows Desktop tiling process.) When the backBrush property is set for a form, the backColor of the form is not used for coloring the background of the form. To clear the backBrush property of a form, set the property to null.

The Window class backBrushStyle property controls the way in which the Control class and Form class backBrush property images are displayed.

To define a binary that is used instead of the Window class backColor property, use the Control class backBrush property. If you set the backBrush property to a valid image (only bitmap, PNG, GIF, TIFF, and JPEG files are supported) and the control is not transparent, the control background is drawn repeatedly by using the specified back-brush to cover the entire control. This picture could be a pattern, an actual picture image, a logo, and so on.

Although you can define a backBrush property value for all controls, the BrowseButtons, Button, Folder, MultiMedia, Ocx, and ActiveXControl controls ignore it because the control is entirely covered by other drawing.

Use the transparent property to enhance the use of the backBrush property; for example, to paint only the text of a label over the backBrush bitmap without erasing the background area of the label.

The backColor property is ignored when the backBrush property is set. The null default value indicates that the backColor property is used to draw the background area of the control unless it is also transparent.

As both the Microsoft Edit control draws the text by using the value of the backColor property rather than that of the backBrush property, the backBrush property is ignored for a TextBox control and the text box part of a ComboBox control.

For details about displaying a background image on a Web form, see the webFileName property.