Color

Description

The text color of the column or the background color of the DataWindow.

The color affected by the Color property depends on the control:

  • For the DataWindow, Color specifies the background color

  • For columns, computed fields, and text, Color specifies the text color

  • For graphs, Color specifies the line color used for axes, borders around data markers, tick marks, and the outline of the box for 3D graphs

Applies to

DataWindow, Button, Column, Graph, and GroupBox controls

Syntax

PowerBuilder dot notation:

   dw_control.Object.DataWindow.Color
   dw_control.Object.controlname.Color

Describe and Modify argument:

   "DataWindow.Color { = long }"
   "controlname.Color { = long }"

SyntaxFromSql:

   DataWindow ( Color = long )
   Column ( Color = long )

Parameter

Description

controlname

The column whose text color you want to set or the graph whose line color you want to set.

long

(exp for columns only) A long value specifying the color of the column text or the DataWindow background. When you are specifying the text color of a column, you can specify a DataWindow expression in quotes. You cannot specify an expression for the DataWindow background color.

When generating DataWindow syntax with SyntaxFromSql, the Color setting for Column applies to all columns.


Usage

In the painter

For the DataWindow background, click the DataWindow to deselect all controls and set the value in the Properties view, Background tab, Color option. If you save to an EMF or WMF, the properties on the Background tab are not saved with the DataWindow.

For a column's text color, select the column and set the value in the Properties view, Font tab, Text Color option.

For a graph's line color, select the graph and set the value in the Properties view, General tab, Text Color option.

Examples

string column_text_color
column_text_color = dw1.Object.emp_name.Color
dw1.Object.salary.Color = &
      "0~tIf(salary>90000,255,65280)"
dw_back_color = dw1.Describe("DataWindow.Color")
column_text_color = dw1.Describe("emp_name.Color")
dw1.Modify( &
      "salary.Color='0~tIf(salary>90000,255,65280)'")

See also

BackColor

Background.property