Value (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Various properties

Value of Static Text control
Value of Calculated control in a report
Value of Bar Code control
Value of Image control
Value of Static Text 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 TreeView control or TreeView Table control
Value of a Progress Bar, Slider, Spin or Scrollbar control
Value of Tab control
Value of menu or menu option
Value of Chart control
Value of OLE control
Value of Rating control
Value of Drawer control
Value of ActiveX control
Value of HTML control
Value of Map control
Value of stream
Value of Site Map Path control
Button, Link and iFrame: URL property and Value property
Upload control
Range Slider control
Value of Spreadsheet control
Value of Sliding Banner control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Value (Property)

In french: Valeur

The Value property 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.
Find out the files managed by an Upload 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.
Find out and modify the lower value of the interval currently selected in a Range Slider control.
Get the value associated with a value of a variable of type Enumeration.
Find out the identifier or the handle associated with a Native Container control.

Remark: The Value property is rarely used and can be replaced by an equivalent syntax (see Remarks).

Example

// Modifier le fichier image associé au champ Image "IMG_Image"
IMG_Image.Valeur = "C:\MesImages\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 the element to be used.

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

The Value property is used to retrieve or modify the text of a Static Text control.

<Result> is a character string.

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

ResLibellé = <Champ Libellé>.Valeur
ResLibellé = <Champ Libellé>
ResLibellé = <Champ Libellé>.Libellé

Value of Calculated control in a report

The Value property is used to retrieve or 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:

ResValeur = <Champ Calculé>.Valeur

ResValeur = <Champ Calculé>

Value of Bar Code control

The Value property is used to retrieve or 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:

ResValeur = <Champ Code-barres>.Valeur

ResValeur = <Champ Code-barres>

Value of Image control

The Value property is used to identify or modify the image file associated with an Image control.

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

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

ResImage = <Champ Image>.Valeur

ResImage = <Champ Image>

Value of Static Text control or preset control found in a report

The Value property is used to identify or modify the content of the control.

In an assignment, the type of the value passed to the Value property 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 you use the right input mask (InputMask property).

A date must be assigned to a Date control.

Value of RTF control

The Value property is used to retrieve or modify the content of an RTF control. This content is composed of RTF-specific characters.

<Result> is a character string.

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

ResRTF = <Champ RTF>.Valeur

ResRTF = <Champ RTF>

Value of window or page

The Value property is used to retrieve or change the title of a window or page.

<Result> is a character string.

The Value and Title properties are equivalent.

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

ResTitre = <Nom de la fenêtre ou de la page>.Valeur

ResTitre = <Nom de la fenêtre ou de la page>

ResTitre = <Nom de la fenêtre ou de la page>.Titre

Value of edit control

The Value property is used to retrieve or change the value entered in an Edit control.

<Result> has the following type:

character string if the subtype of the Edit control corresponds to "Text", "Date" or "Time",
integer or real if the subtype of the Edit control corresponds to "Numeric",
numeric if the subtype 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:

ResValeur = <Champ de saisie>.Valeur

ResValeur = <Champ de saisie>

Value of Button control

The Value property 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.

The Value and Caption properties are equivalent.

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

ResBouton = <Champ Bouton>.Valeur

ResBouton = <Champ Bouton>

ResBouton = <Champ Bouton>.Libellé

The Value property is used to change the image of an Image Button control without a hover image. It is recommended to use the Image property instead to change the image of the Button control.

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

The Value property 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

<Résultat> 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:

ResCoché = <Champ Interrupteur>[<Numéro de l'option>].Valeur

ResCoché = <Champ Interrupteur>[<Numéro de l'option>]

ResCoché = <Nom de l'option>.Valeur

ResCoché = <Nom de l'option>

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

Value of Radio Button control

The Value property 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 = <Champ Sélecteur>.Valeur

ResOption = <Champ Sélecteur>

Note: By default, a Radio Button control is always set to one 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:

// Initialiser la valeur du champ "SEL_Client" avec sa valeur d'origine
SEL_Client.ValeurInitiale = -1

Value of List Box, ListView or Table control

Two distinct cases may occur.

The List Box, ListView or Table control is populated programmatically OR the StoredItem property is set to an empty string ("").
The Value property is used to:
- Get the selected row. If no row is selected, the Value property returns -1. If the control allows for multiple selection, the number of the last selected row is returned.
  To find out the selected row, use one of the following syntaxes:
  ResLigne = <Nom du champ>.Valeur
  
  ResLigne = <Nom du champ>
- Select another row by specifying the number of the new row to select. The rows previously selected are deselected.
The List Box, ListView, or Table controls are based on a data file AND the StoredItem property is not empty.
The Value property is used to identify the stored item for the record associated with the selected row. If no row is selected, the Value property returns an empty string ("").
To find out the stored item associated with the selected row, use one of the following syntaxes:
ResRubMem = <Nom du champ>.Valeur

ResRubMem = <Nom du champ>.RubriqueMémorisée

Reminder: the List Box control is not available for WEBDEV.

ListView controls are not available.

Value of cell in a Table control

The Value property is used to determine or 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:

ResCellule = <Champ Table>[<Numéro de ligne>][<Numéro de colonne>].Valeur

ResCellule = <Champ Table>[<Numéro de ligne>][<Numéro de colonne>]

ResCellule = <Colonne>[<Numéro de ligne>].Valeur

ResCellule = <Colonne>[<Numéro de ligne>]

Special case: Value of a cell in the current line
If only the column name is specified, the Value property can be 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:

ResColonne = <Nom de la colonne>.Valeur

ResColonne = <Nom de la colonne>

Value of Combo Box control

Two distinct cases may occur.

The Combo Box control is editable AND the StoredItem property is set to an empty string ("").
The Value property is used to:
- Find out the value of the selected item. If no element is selected, the Value property returns an empty string ("").
  To find out the value of the selected element, use one of the following syntaxes:
  ResValeur = <Champ Combo>.Valeur
  
  ResValeur = <Champ Combo>
- Modify the value of the selected element.
The Combo Box is not editable OR the StoredItem property is not empty.
The Value property is used to determine the number of the selected element.
To find out the number of the selected element, use one of the following syntaxes:
ResElément = <Champ Combo>.Valeur
ResElément = <Champ Combo>[<Champ Combo>]
ResElément = <Champ Combo>

Value of TreeView control or TreeView Table control

Two distinct cases may occur.

The control is populated programmatically OR the StoredItem property is set to an empty string ("").
The Value property is used to:
- Get the selected row. If no row is selected, the Value property returns -1. If the control allows for multiple selection, the number of the last selected row is returned.
  To find out the selected row, use one of the following syntaxes:
  ResLigne = <Nom du champ>.Valeur
  
  ResLigne = <Nom du champ>
- Select another row by specifying the number of the new row to select. The rows previously selected are deselected.
The control is based on a data file AND the StoredItem property is not empty.
The Value property is used to identify the stored item for the record associated with the selected row. If no row is selected, the Value property returns an empty string ("").
To find out the stored item associated with the selected row, use one of the following syntaxes:
ResRubMem = <Nom du champ>.Valeur

ResRubMem = <Nom du champ>.RubriqueMémorisée

Value of a Progress Bar, Slider, Spin or Scrollbar control

The Value property is used to determine or modify the value in a Progress Bar, Slider, Spin or Scrollbar control.

<Result> is a real.

To find out the value of a Progress Bar, Slider, Spin or Scrollbar control, use one of the following syntaxes:

ResValeur = <Nom du champ>.Valeur

ResValeur = <Nom du champ>

Value of Tab control

The Value property is used to enable a pane in a Tab control or to determine the number of the active pane.

<Result> is an integer.

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

ResVolet = <Champ Onglet>.Valeur

ResVolet = <Champ Onglet>

The Value property is used to determine the number of the active pane in Browser code.

Value of menu or menu option

The Value property is used to determine the number associated with the current menu or menu option.

Note: The number associated with a menu or menu option is defined in the "General" tab of the menu or menu option description.

<Result> is an integer.

To find out the number associated with the menu or with the current menu option, use one of the following syntaxes:

ResMenu = <Nom du menu ou de l'option de menu>.Valeur

ResMenu = <Nom du menu ou de l'option de menu>

Value of Chart control

The Value property can only be used to get 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_NomGraphe = <Champ Graphe>.Valeur

Res_NomGraphe = <Champ Graphe>

Value of OLE control

The Value property is used to initialize an OLE control with an OLE object (equivalent to OLELoad).

Example:

OLE_OLE1.Valeur = "Test.OLE" // Équivalent à OLECharge("OLE_OLE1","Test.OLE")

Value of Rating control

The Value property is used to initialize and determine the value of a Rating control.

This value corresponds to the number of icons displayed in the control.

Example:

NOTE_Nation1.Valeur = 4.5

Note: The Rating control value takes into account the value of a star defined either in the field description or by the ValuePerStar property.

Value of Drawer control

The Value property is used to determine if the Drawer control is expanded (1) or collapsed (0) and to switch between the two states.

Example:

// Enroule le champ Tiroir si celui-ci est déroulé
IF TIR_Tiroir1.Valeur = 1 THEN TIR_Tiroir1.Valeur = 0

Value of ActiveX control

The Value property is used to get the COM identifier (ProgId) of the ActiveX control being used.

Value of HTML control

The Value property is used to get 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.

Value of Map control

The Value property is used to center the map (in a Map control) on the position that corresponds to a geoPosition variable.

Example:

// Centre la carte affichée par le champ "CARTE_Position" sur une position géographique
MaPosition is geoPosition
CARTE_Position.Valeur = MaPosition

Remarks:

The Value property is equivalent to the MapDisplayPosition function. The only difference is that when using the MapDisplayPosition function, positioning on the requested position is carried out using an animation.
The Value property can only be used to change the position in a Map control.
The Value property gets and sets the position in a Map control.

Value of stream

The Value property is used to get the identifier of a stream. The property can be used on the name of the stream or on the name of the Conference control associated with the stream.

Value of Site Map Path control

The Value property is used to get the index of the element in the Breadcrumb control the user has clicked on.

Button, Link and iFrame: URL property and Value property

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

Upload control

The Value property is used to get the list of files selected in an 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 file name corresponds to the path and name of the uploaded temporary file. For example: C\WebDep\Temp\File.upl
This property must be used in the process for receiving 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 in the browser. For example: MyImage.jpg

Range Slider control

The Value property gets and sets the lower bound of the currently selected interval in a Range Slider control. In this case, this property is equivalent to the LowerValue property.

The same rules apply.

Value of Spreadsheet control

The Value property is used to get and modify the binary content of a Spreadsheet control.
For example:

TBLR_Defilé.Valeur = fLoadBuffer(fExeDir() + "\Défilé Haute Couture.xls")

Value of Sliding Banner control

The Value property 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:

ResPlan = <Champ Bandeau défilant>.Valeur

ResPlan = <Champ Bandeau défilant>

Limitations

In a report, the Value property 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.
a Signature control.

In a window, the Value property cannot be used on:

an option in a radio button.
a tab pane.
a group of controls.

The Value property cannot be used on:

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

The Value property can only be used in the following controls:

Static Text control.
Formatted display control.
Button control.
Edit control,
List Box control.
Combo Box control,
Check Box control.
Radio Button control.
Thumbnail control.
iframe control.
Drawer control.
Tab control.
Upload control (single-selection and multi-selection).
Progress Bar control.
Scheduler control.
Slider control (linear slider and range slider).
Sliding Banner control.

The Value property can only be used with the following elements:

Button control.
Static Text control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
Tab control.
Window.
Table control.
Table column.
Supercontrol.

The Value property can only be used with the following elements:

Button control.
Static Text control.
Image control.
Window.