Value (Property)

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 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 name>..Value

<Result>: Any type

This result depends on the element type.

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

Name of element to use.

Modifying the value of an element Hide the details

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

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

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 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 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>

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.