Gradient.property

Description

Settings that control the gradient display in a DataWindow object. Gradient display properties are not supported in RichText, Graph, or OLE DataWindow presentation styles.

Applies to

DataWindows

Syntax

PowerBuilder dot notation:

dw_control.Object.datawindow.gradient.property

Describe and Modify argument:

"DataWindow.gradient.property { = value }"

Parameter

Description

property

A property for the gradient. Properties and their settings are listed in the table that follows.

value

The value to be assigned to the property. For gradient properties, value can be a quoted DataWindow expression.

Property for Gradient

Value

Angle

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 datawindow.brushmode takes values of 3 or 4.

Painter: Background tab, Gradient group.

Color

The gradient color of the DataWindow. This property is only in effect when datawindow.brushmode takes values 1 through 5.

Painter: Background tab, Gradient group

Focus

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

Repetition.Mode

Specifies the mode for determining the number of gradient transitions.

Permitted values and their meanings are:

Painter: Background tab, Gradient group.

Repetition.Count

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 datawindow.brushmode property takes values from 1 to 4 and when the when the datawindow.gradient.repetition.mode value is 0 (by count). The maximum is 10,000.

Painter: Background tab, Gradient group.

Repetition.Length

A long specifying the number of gradient transitions. This property is used only when the datawindow.brushmode property takes values from 1 to 4 and the datawindow.gradient.repetition.mode property takes the value of 1 (by length). The units for the length that you assign for gradient transitions are set by the datawindow.units property.

Painter: Background tab, Gradient group.

Scale

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

Spread

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

Tranparency

An integer in the range 0 to 100, where 0 means that the 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

Usage


In the painter

Select the DataWindow object and set the 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.

Examples

Example 1

string ls_data

ls_data = dw_1.Object.datawindow.brushmode

dw_1.Object.datawindow.Brushmode = 5

ls_data = dw_1.Describe("datawindow.brushmode")

dw_1.Modify("datawindow.Brushmode=6")

dw_1.Modify("datawindow.Gradient.Transparency=75")

See also