DisplayedValue (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Value displayed in an edit control
Value displayed in an HTML Display control
Value displayed in a Combo Box control
Value displayed in a List Box control
Value displayed in a column of a Table control
Value displayed in a row of a Table control
Value displayed in a column of a Table control
Value displayed in a ListView control
Limit

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Properties associated with windows, pages and controls

DisplayedValue (Property)

In french: ValeurAffichée

The DisplayedValue property returns the value currently displayed in the control of a window or page.

Example

// Find out the value displayed on the screen in the "Date" control
EDT_Date = 18031972
Trace(EDT_Date.DisplayedValue) // Displays "18/03/1972"

Syntax

<Displayed value> = <Control used>.DisplayedValue

<Displayed value>: Character string

Value currently displayed on the screen in the specified control.

<Control used>: Control name

Name of the control to be used.

Remarks

Value displayed in an edit control

The DisplayedValue returns the formatted string with its input mask.

Value displayed in an HTML Display control

The DisplayedValue property returns the HTML code contained between the <BODY> and </BODY> tags.

Remarks:

The DisplayedValue property has no effect on HTML Display controls: this property does not return anything.
This property is not available for HTML Display controls. The result corresponds to an empty string.

Value displayed in a Combo Box control

The DisplayedValue property returns the formatted string displayed:

in the edit control if the Combo Box control is editable,
in the current row if the Combo Box control is not editable.

Remark: Use of gImage and gStoredValue
To retrieve the content added with the gImage and gStoredValue functions, use the InitialValue property.
For example, if the following code is used to add an element:

ListAdd(COMBO_Combo1, gImage(nImageNum,i) + "Customer.CustomerName" + i + ...
StoredValue("Customer.CustomerName" + i))

the following code is used to read the initial string again:

COMBO_Combo1[1].InitialValue

Value displayed in a List Box control

The DisplayedValue property returns:

the formatted string displayed in the specified row if a row number is specified,
the formatted string displayed in the current row if no row number is specified.

Value displayed in a column of a Table control

The DisplayedValue property returns the formatted string displayed in the cell corresponding to the specified column and the current row.

Value displayed in a row of a Table control

The DisplayedValue property returns the formatted string displayed in the cell corresponding to the specified column and the specified row.

Value displayed in a column of a Table control

The DisplayedValue property returns the values of each column of the specified row separated by TAB.

Remark: The DisplayedValue property does not return the value of invisible columns.

Value displayed in a ListView control

The DisplayedValue property returns:

the caption of the element displayed in the specified row if a row number is specified,
the caption of the element displayed in the current row if no row number is specified.

Limit

The DisplayedValue property applies only to:

Edit controls,
Combo Box controls,
List Box controls and rows in a List Box control,
Columns and rows in a Table control,
Rows in a Table control,
Static controls,
HTML controls.
Image controls.
Clickable Image controls.
Thumbnail controls.

In Java, the DisplayedValue property applies only to the following elements:

Edit control.
List Box control.
Combo Box control.
Column of Table control.

In browser code, the DisplayedValue property only applies to the following elements:

Edit control.
Formatted display control.