Value (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Value of Static control
Value of Calculated control in a report
Value of Bar Code control
Value of Image control
Value of Static control or preset control found in a report
Value of RTF control
Value of window or page
Value of edit control
Value of Button control
Value of Check Box control or value of option in a Check Box control
Value of Radio Button control
Value of List Box, ListView or Table control
Value of cell in a Table control
Value of Combo Box control
Value of Tab control
Value of Chart control
Value of Rating control
Value of Drawer control
Value of HTML control
Value of Map control
Value of Site Map Path control
Button, Link and iFrame: ..URL property and ..Value property
Upload control
Range Slider control
Value of Sliding Banner control
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Value (Property)

In french: Valeur

..Value is used to:

Find out and modify the value of a report control.
Find out and modify the value of a control or the title of a window.
Find out the identifier of a stream.
Find out and modify the value of a control or the title of a page.
Versions 15 and later
Find out the files managed by an Upload control.
New in version 15
Find out the files managed by an Upload control.
Find out the files managed by an Upload control.
Versions 22 and later
Find out and modify the plane currently displayed in a Sliding Banner control.
New in version 22
Find out and modify the plane currently displayed in a Sliding Banner control.
Find out and modify the plane currently displayed in a Sliding Banner control.
Center the map found in a Map control on a specific position.
Versions 18 and later
Find out and modify the lower value of the interval currently selected in a Range Slider control.
New in version 18
Find out and modify the lower value of the interval currently selected in a Range Slider control.
Find out and modify the lower value of the interval currently selected in a Range Slider control.
Versions 18 and later
Find out the value associated with a value of an Enumeration variable.
New in version 18
Find out the value associated with a value of an Enumeration variable.
Find out the value associated with a value of an Enumeration variable.

Remark: ..Value is rarely used and it can be replaced by an equivalent syntax (see Notes).

Example

// Modify the image file associated with the "IMG_Image" control
IMG_Image..Value = "C:\MyImages\Image.BMP"

Syntax

Finding out the value of an element Hide the details

<Result> = <Element used>..Value

<Result>: Any type

This result depends on the element type.

<Element used>: Type of element

Name of element to use.

Modifying the value of an element Hide the details

<Element used>..Value = <New value>

<Element used>: Type of element

Name of element to use.

<New value>: Any type

New value for the specified element. This parameter depends on the type of specified element.

Remarks

Value of Static control

..Value is used to find out and modify the text of a Static control.

<Result> is a character string.

To retrieve the text of a Static control, the following syntaxes are equivalent:

ResCaption = <Name of Static control>..Value
ResCaption = <Name of Static control>
ResCaption = <Name of Static control>..Caption

Value of Calculated control in a report

..Value is used to find out and modify the value of a Calculated control in a report.

The type of <Result> depends on the type of the Calculated control.

To retrieve the value of a Calculated control, use one of the following syntaxes:

ResValue = <Name of Calculated control>..Value

ResValue = <Name of Calculated control>

Value of Bar Code control

..Value is used to find out and modify the value of a Bar Code control. The value of a Bar Code control corresponds to the character string represented in the bar code.

<Result> is a character string.

To retrieve the text of a Bar Code control, use one of the following syntaxes:

ResValue = <Name of Bar Code control>..Value

ResValue = <Name of Bar Code control>

Value of Image control

..Value is used to find out and modify the image file associated with an Image control.

<Result> is a character string containing the path of the image file.

To find out the image file associated with an Image control, use one of the following syntaxes:

ResImage = <Name of Image control>..Value

ResImage = <Name of Image control>

Value of Static control or preset control found in a report

..Value is used to find out and modify the content of the control.

In assignment, the type of the value passed to ..Value depends on the type of the item associated with the control.

If the item is numeric, you must assign a number to it and make sure the input mask is appropriate (..InputMask).

A date must be assigned to a Date control.

Value of RTF control

..Value is used to find out and modify the content of an RTF control. The value contains the special characters specific to the RTF format.

<Result> is a character string.

To retrieve the content of an RTF control, use one of the following syntaxes:

ResRTF = <Name of RTF control>..Value

ResRTF = <Name of RTF control>

Value of window or page

..Value is used to find out and modify the title of a window or page.

<Result> is a character string.

..Value is equivalent to ..Title.

To find out the title of a window or the title of a page, use one of the following syntaxes:

ResTitle = <Name of window or page>..Value

ResTitle = <Name of window or page>

ResTitle = <Name of window or page>..Title

Value of edit control

..Value is used to find out and modify the value typed in an edit control.

<Result> has the following type:

character string if the sub-type of edit control corresponds to "Text", "Date" or "Time",
integer or real if the sub-type of the edit control corresponds to "Numeric",
numeric if the sub-type of the edit control corresponds to "Currency" or "Currency + Euro".

To find out the value typed in an edit control, use one of the following syntaxes:

ResValue = <Name of Edit control>..Value

ResValue = <Name of Edit control>

Value of Button control

..Value is used to retrieve and modify the text of a Button control.

If the Button control contains an image, only the text is returned. It is not possible to assign a drawing to a Button control.

<Result> is a character string.

..Value is equivalent to ..Caption.

To know the text of a Button control, use one of the following syntaxes:

ResButton = <Name of Button control>..Value

ResButton = <Name of Button control>

ResButton = <Name of Button control>..Caption

On an Image Button control without a hover image, ..Value allows you to modify the image of the Button control. We recommend that you use ..Image to modify the image of the Button control.

Value of Check Box control or value of option in a Check Box control

..Value is used to:

Check or uncheck an option in a Check Box control.
Find out whether an option found in a Check Box control is checked or unchecked

<Result> is a boolean:

True if the option is checked,
False otherwise.

To find out whether an option found in a Check Box control is checked or not, use one of the following syntaxes:

ResChecked = <Name of Check Box control>[<Option number>]..Value

ResChecked = <Name of Check Box control>[<Option number>]

ResChecked = <Option name>..Value

ResChecked = <Option name>

Remark: If <Option number> is not specified, the first option is selected by default.

Value of Radio Button control

..Value is used to:

Find out the active option in a Radio Button control.
Select an option.

<Result> is an integer.

To find out the active option in a Radio Button control, use one of the following syntaxes:

ResOption = <Name of Radio Button control>..Value

ResOption = <Name of Radio Button control>

Remark: A Radio Button control is always positioned on a position (1 by default). To display a Radio Button control with no default option, all you have to do is assign -1 to the control value during its initialization:

// Initialize the value of "RADIO_Customer" with its initial value
RADIO_Customer..InitialValue = -1

Value of List Box, ListView or Table control

Two distinct cases may occur.

The List Box (ListView or Table) control is a memory control OR ..StoredItem corresponds to an empty string ("").
..Value is used to:
- Find out the selected row. If no row is selected, ..Value returns -1. If the control allows for multiselection, the number of the last selected row is returned.
  To find out the selected row, use one of the following syntaxes:
  
  ResRow = <Control name>..Value
  
  ResRow = <Control name>
- Move the selection by specifying the number of the new row to select. The rows that were selected beforehand are deselected.
The List Box (ListView or Table) control is a browsing control AND ..StoredItem is not empty.
..Value is used to find out the stored item for the record associated with the selected row. If no row is selected, ..Value returns an empty string ("").
To find out the stored item associated with the selected row, use one of the following syntaxes:

ResStoredItem = <Control name>..Value

ResStoredItem = <Control name>..StoredItem

Reminder: the ListView control is not available for WEBDEV.

Value of cell in a Table control

..Value is used to find out and modify the value of a cell in a Table control.

<Result> is a character string.

To find out the value of a cell, use one of the following syntaxes:

ResCell = <Name of Table control>[<Row number>][<Column number>]..Value

ResCell = <Name of Table control>[<Row number>][<Column number>]

ResCell = <Column name>[<Row number>]..Value

ResCell = <Column name>[<Row number>]

Special case: Value of cell in the current row
If only the name of the column is specified, ..Value is used to:

Find out the value of the cell identified by the specified column and by the current row in the Table control. If there is no current row, an empty string ("") is returned.
Modify the value of the cell identified by the specified column and by the current row in the Table control.

<Result> is a character string.

To find out the value of the cell identified by the specified column and by the current row in the Table control, use one of the following syntaxes:

ResColumn = <Column name>..Value

ResColumn = <Column name>

Value of Combo Box control

Two distinct cases may occur.

The Combo Box control is editable AND ..StoredItem corresponds to an empty string ("").
..Value is used to:
- Find out the value of selected item. If no element is selected, ..Value returns an empty string ("").
  To find out the value of the selected element, use one of the following syntaxes:
  
  ResValue = <Name of Combo Box control>..Value
  
  ResValue = <Name of Combo Box control>
- Modify the value of the selected element.
The Combo Box is not editable OR ..StoredItem is not empty.
..Value is used to find out the number of the selected element.
To find out the number of the selected element, use one of the following syntaxes:

ResElement = <Name of Combo Box control>..Value
ResElement = <Name of Combo Box control>[<Name of Combo Box control>]
ResElement = <Name of Combo Box control>

Value of Tab control

..Value is used to find out the number of the active tab pane or to enable a pane in a Tab control.

<Result> is an integer.

To find out the number of the active tab pane, use one of the following syntaxes:

ResPane = <Name of Tab control>..Value

ResPane = <Name of Tab control>

..Value is used to find out the number of the active tab pane in browser code.

Value of Chart control

..Value can only be used to find out the name of a Chart control.

<Result> is a character string.

To find out the name of a Chart control, use one of the following syntaxes:

Res_ChartName = <Name of Chart control>..Value

Res_ChartName = <Name of Chart control>

Value of Rating control

..Value is used to initialize and find out the value of a Rating control.

This value corresponds to the number of "pictograms" displayed in the control.

Example:

RATE_Nation1..Value = 4.5

Value of Drawer control

..Value is used to find out whether the Drawer control is expanded (1) or collapsed (0) and to modify its state.

Example:

// Collapses the Drawer control if it is expanded
IF DRW_Drawer1..Value = 1 THEN DRW_Drawer1..Value = 0

Value of HTML control

..Value is used to find out the address associated with the HTML page displayed in the control. If the page:

is a page built in HTML directly, the value corresponds to "about:blank".
is a page from a site, the value corresponds to the address of the page (www.windev.com for example).
is an HTML file, the value corresponds to the address of the file.

Versions 17 and later

Value of Map control

..Value is used to center the map (found in a Map control) on the position corresponding to a geoPosition variable.

Example:

// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition

MAP_Position..Value = MyPosition

Remarks:

Using ..Value is equivalent to MapDisplayPosition. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
..Value can only be used to modify the position in a Map control.
..Value is used to find out and modify the position in a Map control.

New in version 17

Value of Map control

..Value is used to center the map (found in a Map control) on the position corresponding to a geoPosition variable.

Example:

// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition

MAP_Position..Value = MyPosition

Remarks:

Using ..Value is equivalent to MapDisplayPosition. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
..Value can only be used to modify the position in a Map control.
..Value is used to find out and modify the position in a Map control.

Value of Map control

..Value is used to center the map (found in a Map control) on the position corresponding to a geoPosition variable.

Example:

// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition

MAP_Position..Value = MyPosition

Remarks:

Using ..Value is equivalent to MapDisplayPosition. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
..Value can only be used to modify the position in a Map control.
..Value is used to find out and modify the position in a Map control.

Value of Site Map Path control

..Value is used to find out the subscript of the element that was clicked by the user in the Site Map Path control.

Button, Link and iFrame: ..URL property and ..Value property

..URL and ..Value have the same effect on the Button, Link and iFrame controls. These properties are used to find out the address associated with the control.

Versions 15 and later

Upload control

..Value is used to find out the list of files selected in a multifile Upload control. The names of files are separated by CR characters (Carriage Return). For a single-file Upload control, only the name of the selected file is returned.

The name of the files corresponds to the path and to the name of the temporary uploaded file. For example: C\WebDep\Temp\File.upl
This property must be used in the process for Receiving the uploaded files. In the other cases, this property returns an empty string ("").

This property is equivalent to ..Content in server code on the Upload control.

The name of the files corresponds to the name of the file displayed on he browser. For example: MyImage.jpg

New in version 15

Upload control

This property is equivalent to ..Content in server code on the Upload control.

The name of the files corresponds to the name of the file displayed on he browser. For example: MyImage.jpg

Upload control

This property is equivalent to ..Content in server code on the Upload control.

The name of the files corresponds to the name of the file displayed on he browser. For example: MyImage.jpg

Versions 18 and later

Range Slider control

..Value is used to find out and modify the lower bound of the interval currently selected in a Range Slider control. In this case, this property is equivalent to ..LowerValue.

The same rules apply.

New in version 18

Range Slider control

..Value is used to find out and modify the lower bound of the interval currently selected in a Range Slider control. In this case, this property is equivalent to ..LowerValue.

The same rules apply.

Range Slider control

..Value is used to find out and modify the lower bound of the interval currently selected in a Range Slider control. In this case, this property is equivalent to ..LowerValue.

The same rules apply.

Versions 22 and later

Value of Sliding Banner control

..Value is used to:

find out the number of the plane displayed in a Sliding Banner control.
display a specific plane in a Sliding Banner control.

<Result> is an integer.

To find out the number of the plane displayed in a Sliding Banner control, use one of the following syntaxes:

ResPlane = <Name of Scroling Banner control>..Value

ResPlane = <Name of Scroling Banner control>

New in version 22

Value of Sliding Banner control

..Value is used to:

find out the number of the plane displayed in a Sliding Banner control.
display a specific plane in a Sliding Banner control.

<Result> is an integer.

To find out the number of the plane displayed in a Sliding Banner control, use one of the following syntaxes:

ResPlane = <Name of Scroling Banner control>..Value

ResPlane = <Name of Scroling Banner control>

Value of Sliding Banner control

..Value is used to:

find out the number of the plane displayed in a Sliding Banner control.
display a specific plane in a Sliding Banner control.

<Result> is an integer.

To find out the number of the plane displayed in a Sliding Banner control, use one of the following syntaxes:

ResPlane = <Name of Scroling Banner control>..Value

ResPlane = <Name of Scroling Banner control>

Limits

For the reports, ..Value cannot be used on:

a report.
a report block.
a Check Box control.
a Shape control.
an Organizer control.
a Scheduler control.
a Gantt Chart control.
Versions 21 and later
a Signature control.
New in version 21
a Signature control.
a Signature control.

..Value cannot be used on:

an option in a radio button,
a group of controls.

..Value operates on the following controls:

Static control.
Formatted display control.
Button control.
Edit control,
List Box control.
Combo Box,
Check Box control.
Radio Button control.
Looper control.
Thumbnail control.
iFrame control.
Drawer control.
Tab control.
Versions 15 and later
Upload control (single-selection and multi-selection).
New in version 15
Upload control (single-selection and multi-selection).
Upload control (single-selection and multi-selection).
Versions 16 and later
Progress Bar control.
New in version 16
Progress Bar control.
Progress Bar control.
Versions 16 and later
Scheduler control.
New in version 16
Scheduler control.
Scheduler control.
Versions 18 and later
Slider control (linear slider and range slider).
New in version 18
Slider control (linear slider and range slider).
Slider control (linear slider and range slider).
Versions 22 and later
Sliding Banner control.
New in version 22
Sliding Banner control.
Sliding Banner control.