Color (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Font variable
Color of an edit control
Text color in a Static control
Text color of a Button control
Color of the text in a Radio Button or Check Box control
Color of the text in a List Box or Combo Box control
Text color of a cell, row or column in a Table control
Color of an Image control
Color of the tabs in a Tab control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Color (Property)

In french: Couleur

The Color property is used to get or change the font color for:

a variable of type Font.
text displayed in a Static or Calculated control of a report.
text displayed in a window control.
text displayed in a page control.
Versions 16 and later
text in a menu option.
New in version 16
text in a menu option.
text in a menu option.

The effects of the Color property depend on the type of control (for more details, see "Remarks").

Remark: A Font variable is black by default.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for window controls and Font variables in iPhone/iPad applications.

New in version 17

This property is now available for window controls and Font variables in iPhone/iPad applications.

Versions 18 and later

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

This property is now available in Android widget mode.

New in version 18

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

This property is now available in Android widget mode.

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

This property is now available in Android widget mode.

Versions 20 and later

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

New in version 20

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

Versions 21 and later

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

New in version 21

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

Versions 22 and later

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

New in version 22

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

Versions 27 and later

This property is now available for Font variables in Android applications.

This property is now available for Font variables in Android widget mode.

New in version 27

This property is now available for Font variables in Android applications.

This property is now available for Font variables in Android widget mode.

This property is now available for Font variables in Android applications.

This property is now available for Font variables in Android widget mode.

Example

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

// Define the characteristics of a Font variable
Font1 is Font
Font1.Name = "Arial"
Font1.Color = LightYellow
Font1.Size = 14
Font1.SizeUnit = unitPoint
Font1.Orientation = 45
// Apply the font to "MyControl"
MyControl.Font = Font1

Syntax

Finding out the text color Hide the details

<Result> = <Element used>.Color

<Result>: Integer or constant

Color of specified element. This color can correspond to:
an RGB color (returned by RGB),
a preset color.

<Element used>: Control name or Font variable

Name of element for which the text color must be found. This element can correspond to:
the name of a control in a window or in a page.
the name of a report control.
name of a variable of type Font.

Changing the text color Hide the details

<Element used>.Color = <New color>

<Element used>: Control name or Font variable

Name of element for which the text color must be modified. This element can correspond to:
the name of a control in a window or in a page.
the name of a report control.
name of a variable of type Font.

<New color>: Integer or constant

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

Remarks

Font variable

A font can be created from a Font variable.

To define the font characteristics, use:

the FontCreate function.
This function is not available.
the Charset, Orientation, StrikeOut, Color, Bold, Italic, CharacterSpacing, LineSpacing, Name, Underline, Size and SizeUnit properties.
Only the following properties can be used with the Font type: Orientation, StrikeOut, Color, Bold, Italic, Name, Underline, Size.
Versions 27 and later
The Charset and Orientation properties are not available for Font variables.
New in version 27
The Charset and Orientation properties are not available for Font variables.
The Charset and Orientation properties are not available for Font variables.

This font can be used:

To write text in drawings (dFont).
To write in charts (grLabelFont, grLegendFont, grTitleFont and grAxisTitleFont).
To print (iFont).
In the controls of a window (Font property).
In the controls of a report (Font property).

Versions 27 and later

This font can only be used in the controls of a window (Font property).

New in version 27

This font can only be used in the controls of a window (Font property).

Assigning a font to a control:

if the Font variable has no specific color, the color of the text displayed in the control is kept.
if the Font variable has a specific color, this color is applied to the text displayed in the control.

Color of an edit control

The Color property is used to get and change the color of the text entered in a control.

Text color in a Static control

The Color property is used to get and change the text color of a Static control.

Text color of a Button control

The Color property is used to get and change the text color of a Button control.

Color of the text in a Radio Button or Check Box control

The Color property is used to get and change the text color of all the options of a Radio Button or Check Box control.

Color of the text in a List Box or Combo Box control

The Color property is used to get and change the text color of all the options in a List Box control.

To get or change the text color of an option in a List Box control, specify the element using the following syntax: ListName[RowNum].
For example, the following code is used to color the text of the second row of the List Box control green:

LIST_List1[2].Color = LightGreen

Caution: In List Box controls, the new color is kept for the visible rows only.

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

To find out or modify the text color of an option in a Table control, specify the cell with the following syntax: TableName[RowNum][ColumnNum].
For example, the following code is used to modify the color of the text displayed in the cell on the first row, second column:

TABLE_Table1[1][2].Color = DarkBlue

To find out or modify the text color of a row in a Table control, specify the row with the following syntax: TableName[RowNum].
To get or change the text color of a column in a Table control, simply use the Color property with the column name.

Caution: To keep the text color when selecting a row in a Table control based on a data file, simply use the Color property in the "Select a row" event.

Color of an Image control

The Color property is used to get and change the background color of an Image control.

Color of the tabs in a Tab control

When used on a Tab control, the Color property allows you to get and change the background color of the tabs.

When used on a tab, the Color property allows you to get and change the text color of the tabs.

For example:

// Modifies the color of the caption for pane 1
TAB_MyTab[1].Color = LightRed

Limitations

Limitations on report controls
The Color property has no effect on:

Image controls.
Bar Code controls.
RTF controls.
Check Box controls.
Chart controls.
Versions 21 and later
Signature controls.
New in version 21
Signature controls.
Signature controls.
reports.
report blocks.

The Color property applies only to the following elements:

Button control.
Static control.
Image control.

The Color property applies only to the following elements:

Static control.
Image control.
Window.