Background.property – PB Docs 2017

controlname

The control whose Background properties you want to
get or set.

When generating DataWindow syntax with
SyntaxFromSql, the Background settings apply to all columns or
all text controls.

property

A property that applies to the background of a
control, as listed in the Property table below.

value

Values for the properties are shown below.
Value can be a quoted DataWindow expression.

Brushmode

(exp) An integer indicating the type of “brush” to
use for the gradient.

Values
are:

Painter: Background tab, Gradient group (not
available in RichText, Graph, or OLE DataWindow
objects).

Color

(exp) A long expression specifying the color (the
red, green, and blue values) to be used as the control’s
background color.

Painter: Background
tab

Mode

(exp) A number expression specifying the mode of
the background of controlname.

Values
are:

0 — Make the control’s background
opaque

1 — make the control’s background
transparent

Transparency

(exp) An integer in the range 0 to 100, where 0
means that the column or control’s primary background is opaque
and 100 that it is completely transparent.

Painter:
Background tab.

Gradient.Angle

(exp) An integer indicating the angle in degrees
(values are 0 to 360) used to offset the color and transparency
gradient. This property is used only when the column’s or
control’s background.gradient.mode takes values of 3 or
4.

Painter: Background tab, Gradient
group.

Gradient.Color

(exp) A long specifying the color (the red, green,
and blue values) to be used as the column or control’s secondary
background color. The gradient defines transitions between the
primary and secondary background colors.

Painter:
Background tab, Gradient group.

Gradient.Focus

(exp) An integer in the range 0 to 100, specifying
the distance (as a percentage) from the center where the
background color is at its maximum. (For example, if the radial
gradient is used and the value is set to 0, the color will be at
the center of the background; if the value is set to 100, the
color will be at the edges of the
background.)

Painter: Background tab, Gradient
group

Gradient.Repetition.Mode

(exp) Specifies the mode for determining the number
of gradient transitions for the column’s or control’s background
color and transparency.

Permitted values and their
meanings are:

Painter: Background tab, Gradient
group.

Gradient.Repetition.Count

(exp) An integer specifying the number of gradient
transitions for background color and transparency. A value of 0
indicates 1 transition. A value of 3 indicates 4 transitions.
This property is used only when the gradient.repetition.mode
property for the column or control takes the value of 0 (by
count).

Painter: Background tab, Gradient
group.

Gradient.Repetition.Length

(exp) A long specifying the number of gradient
transitions. This property is used only when the
gradient.repetition.mode property for the column or control
takes the value of 1 (by length). The units for the length that
you assign for gradient transitions are set by the DataWindow
object’s Units property.

Painter: Background tab,
Gradient group.

Gradient.Scale

(exp) An integer in the range 0 to 100 specifying
the rate of transition to the gradient color (as a
percentage).

Painter: Background tab, Gradient
group

Gradient.Spread

(exp) An integer in the range 0 to 100 indicating
the contribution of the second color to the blend (as a
percentage).

Painter: Background tab, Gradient
group

Gradient.Transparency

(exp) An integer in the range 0 to 100, where 0
means that the column or control’s secondary (gradient)
background is opaque and 100 that it is completely transparent.
The gradient defines transitions between the primary and
secondary transparency settings.

Painter: Background
tab, Gradient group.