Brushmode

Description

Setting that controls the type of “brush” used for the background or primary gradient.

Applies to

DataWindows

Syntax

PowerBuilder dot notation:

dw_control.brushmode

Describe and Modify argument:

“DataWindow (brushmode = { integer } )”

Parameter

Description

integer

The value to be assigned to the property:

  • 0 – Solid

  • 1 – HorizontalGradient

  • 2 – VerticalGradient

  • 3 – AngleGradient

  • 4 – ScaledAngleGradient

  • 5 – RadialGradient

  • 6 – Picture

Usage


In the painter

Set the brushmode value on the Background tab of the Properties view.

If you save to an EMF or WMF, the properties on the Background tab are not saved with the DataWindow.

The following table explains the possible values for Brushmode:

Value

Description

0 - Solid

The background is a solid color as selected

1 - HorizontalGradient

The color changes horizontally from the primary color (and transparency) to the secondary color (and transparency). The primary values are defined by the datawindow.color and datawindow.transparency, and the secondary values are defined by datawindow.gradient.color and datawindow.gradient.transparency. The gradient can be repeated using the datawindow.gradient.repetition.mode property.

2 - VerticalGradient

The color changes vertically from the background color (and transparency) to the secondary color (and transparency). The primary values are defined by the datawindow.color and datawindow.transparency, and the secondary values are defined by datawindow.gradient.color and datawindow.gradient.transparency. The gradient can be repeated using the datawindow.gradient.repetition.mode property.

3 - AngleGradient

The color changes at a specific angle off the horizontal from the background color (and transparency) to the secondary color (and transparency). The angle is specified in datawindow.gradient.angle. The primary values are defined by the datawindow.color and datawindow.transparency, and the secondary values are defined by datawindow.gradient.color and datawindow.gradient.transparency. The gradient can be repeated using the datawindow.gradient.repetition.mode property.

4 - ScaledAngleGradient

The color changes at an angle, which adjusts according to the changes in the aspect ratio of the DataWindow control. The starting angle is specified in datawindow.gradient.angle. The primary values are defined by the datawindow.color and datawindow.transparency, and the secondary values are defined by datawindow.gradient.color and datawindow.gradient.transparency. The gradient can be repeated using the datawindow.gradient.repetition.mode property.

5 - RadialGradient

The background color (and transparency) starts at the center and slow changes to the gradient color (and transparency) at the boundaries of the DataWindow. The primary values are defined by the datawindow.color and datawindow.transparency, and the secondary values are defined by datawindow.gradient.color and datawindow.gradient.transparency.

6 - Picture

A picture is used as the background. The image is specified in datawindow.picture.file.

See also