BackgroundColor (Property)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Background color of an edit control
Background color of a List Box or Combo Box control
Background color of window
Background color of Static control
Background color of button
Background color of Radio Button or Check Box control
Background color of ListView control
Background color of TreeView control
Background color of a Table control or a cell, column or row in a Table control
Background color of cell
Background color of Tab control
Background color of Sidebar control
Background color of Scrollbar or Spin control
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BackgroundColor (Property)

In french: CouleurFond

Warning
From version 24, BrushColor is kept for backward compatibility. This function is replaced by BackgroundColor.

..BackgroundColor is used to find out and modify the background color of:

a control.
a window.
a page.
a report block.
Versions 16 and later
a caption of a menu option.
New in version 16
a caption of a menu option.
a caption of a menu option.

Note: The effects of ..BackgroundColor depend on the type of control (see "Remarks" for more details).

The modification is available for the "Automatic" or "Dynamic" controls only ("Details" tab of control description).

The modification is available for the "Automatic" or "Dynamic" controls only ("GUI" tab of control description).

Versions 16 and later

This property is now available for the Windows Phone applications.

New in version 16

This property is now available for the Windows Phone applications.

Versions 15 and later

This property is now available for the Android applications.

New in version 15

This property is now available for the Android applications.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

This property is now available for the report controls and blocks in the iPhone/iPad applications.

This property is now available in Android Widget mode.

New in version 18

This property is now available in Windows Store apps mode.

This property is now available for the report controls and blocks in the iPhone/iPad applications.

This property is now available in Android Widget mode.

This property is now available in Windows Store apps mode.

This property is now available for the report controls and blocks in the iPhone/iPad applications.

This property is now available in Android Widget mode.

Versions 19 and later

This function is now available in browser code for Table controls in browser mode.

New in version 19

This function is now available in browser code for Table controls in browser mode.

Versions 20 and later

This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.

New in version 20

This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

Example

// The background color is modified according to the displayed value
IF EDT_Total > 15000 THEN
EDT_Total..BackgroundColor = LightRed
END

Syntax

Finding out the background color Hide the details

<Background color> = <Element name>..BackgroundColor

<Background color>: Integer or constant

Color of specified element. This color corresponds to:
an RGB color (returned by RGB),
a preset color.
The color is returned in the format of a character string by the browser.

<Element name>: Character string (with or without quotes)

Name of element to use: control, window, page or report block.

Modifying the background color Hide the details

<Element name>..BackgroundColor = <New color>

<Element name>: Character string (with or without quotes)

Name of element to use: control, window, page or report block.

<New color>: Integer or constant

New color for the specified element. This color corresponds to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color.

Remarks

Background color of an edit control

..BackgroundColor is used to find out and modify the background color of the text typed.

Background color of a List Box or Combo Box control

..BackgroundColor is used to find out and modify the background color of:

All the options of the control.
A single option.
This feature is not available in WEBDEV.

To find out or modify the background color of an option found in the List Box control, use the following syntax to identify the element of the List Box control:

NameListBoxControl[RowNum]

For example, the following code is used to modify the background color of the second row in the List Box control:

LIST_List1[2]..BackgroundColor = LightGreen

Caution: For the rows in a List Box control, the new color is stored for the visible rows only.

Background color of window

If the window is not an "MDI parent" window, ..BackgroundColor is used to find out and modify the background color of the client area of the window.

Background color of Static control

..BackgroundColor is used to find out and modify the background color of the text displayed a Static control.

Background color of button

..BackgroundColor is used to modify the background color of a button.

Background color of Radio Button or Check Box control

..BackgroundColor is used to find out and modify the background color of a Radio Button or Check Box control.

Background color of ListView control

..BackgroundColor is used to find out and modify the background color of:

All the options of the ListView control.
A single option.

To find out or modify the background color of an option in the ListView control, use the following syntax to identify the element :

NameListViewControl[RowNum]

Example: the following code is used to modify the background color of the second row in the ListView control:

LSI_ImageList1[2]..BackgroundColor = LightGreen

Background color of TreeView control

..BackgroundColor is used to find out and modify the background color of:

All the options of the TreeView control.
A single option.

To find out or modify the background color of an option in the TreeView control, use the following syntax to identify the element in the TreeView control:

TreeViewName[RowNum]

Example: the following code is used to modify the background color of the second row:

TREE_Treeview1[2]..BackgroundColor = LightGreen

Background color of a Table control or a cell, column or row in a Table control

Used on the entire Table control, ..BackgroundColor allows you to:

Delete the colors specific to the cells and columns via the following syntax:

<Name of Table control>..BackgroundColor = DefaultColor
Modify the background color of all columns in the Table control (especially the uncolored columns and cells). For example, the following code is used color all the columns in blue:

<Name of Table control>..BackgroundColor = DarkBlue

This property is also used to find out and modify the background color of a cell in a Table control. The following syntax must be used to identify the cell:

NameTableControl[RowNum][ColumnNum]

Example: The following code is used to modify the background color of the cell found in first row, second column.

TABLE_Table1[1][2]..BackgroundColor = DarkBlue

Caution: To keep the background color when selecting a row in a browsing Table control, ..BackgroundColor must be used in the process named "Selecting a table row".

Note: To modify the style of the background color in a cell, column or row found in a Table or in a TreeView Table control, use ..BrushStyle.

Versions 19 and later

..BackgroundColor is available in browser code only for browser Table controls on:

Rows of the Table control (browser).
Columns of the Table control (browser).
Cells of the Table control (browser).

This property is not available in browser code for classic or Ajax Table controls.

New in version 19

..BackgroundColor is available in browser code only for browser Table controls on:

Rows of the Table control (browser).
Columns of the Table control (browser).
Cells of the Table control (browser).

This property is not available in browser code for classic or Ajax Table controls.

..BackgroundColor is available in browser code only for browser Table controls on:

Rows of the Table control (browser).
Columns of the Table control (browser).
Cells of the Table control (browser).

This property is not available in browser code for classic or Ajax Table controls.

Versions 20 and later

The Table controls are now available in the iOS and Android applications.

New in version 20

The Table controls are now available in the iOS and Android applications.

Background color of cell

..BackgroundColor is used to find out and modify the background color of the cells found in the WEBDEV pages.

Background color of Tab control

For the Tab controls:

..Color is used to find out and modify the background color of tab panes.
..BackgroundColor is used to find out and modify the background color of Tab control (background color that appears behind the tab panes).

..BackgroundColor applied to the tab panes is used to find out and modify the background color of the tab pane.

Background color of Sidebar control

..BackgroundColor is used to find out and modify the background color of the Sidebar control. ..Color is used to find out and modify the background color of sidebar panes.

Background color of Scrollbar or Spin control

..BackgroundColor is used to modify the background color of a Scrollbar control (color used in the bar of the scrollbar).

Limits

Limits for the report controls
..BackgroundColor has no effect on:

the reports (as a whole).
the Internal Report controls.
Versions 21 and later
the Signature controls.
New in version 21
the Signature controls.
the Signature controls.

the Chart controls.

Limits for the controls of WINDEV windows
..BackgroundColor has no effect on the following controls:

the HTML controls,
the Web Camera controls,
the sliders.

the supercontrols,

the menu options.

Versions 22 and later
..BackgroundColor is now available for the break headers and footers found in the Table and Looper controls.

New in version 22
..BackgroundColor is now available for the break headers and footers found in the Table and Looper controls.

..BackgroundColor is now available for the break headers and footers found in the Table and Looper controls.

Limits for the controls of WINDEV Mobile windows
..BackgroundColor has no effect on the following controls:

the supercontrols,
the sliders.
the entire TreeView control.

the menu options.

Limits for the page controls
..BackgroundColor has no effect on:

the elements in a List Box or Combo Box control.
the menu options.

..BackgroundColor has no effect on the elements found in a List Box or Combo Box control.

In browser code, ..BackgroundColor operates on the following controls:

the edit controls,
the List Box controls and the elements of a List Box control,
the Combo Box controls and the elements of a Combo Box control,
the table rows,
the Static and HTML Static controls.
the 3-state Button controls.
the Check Box and Radio Button controls.
the Image controls, the clickable Image controls.
the formatted display controls.
the Link controls.
the HTML controls.
the cells.
the Thumbnail controls.
the iFrame controls.
Versions 19 and later
the rows of the browser Table control.
New in version 19
the rows of the browser Table control.
the rows of the browser Table control.
Versions 19 and later
the columns of the browser Table control.
New in version 19
the columns of the browser Table control.
the columns of the browser Table control.
Versions 19 and later
the cells of the browser Table control.
New in version 19
the cells of the browser Table control.
the cells of the browser Table control.

..BackgroundColor also operates on the pages.

..BackgroundColor only applies to the following elements:

Button control.
Static control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
TreeView control.
Tab control.
Window.
Table control.
Column of Table control.

..BackgroundColor only applies to the following elements:

Button control.
Static control.
Image control.
Window.