PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • 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: Property URL and Property Value
  • Upload control
  • Range Slider control
  • Value of Sliding Banner control
  • Limits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
The Property Value allows 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
    WEBDEV - Server codeWEBDEV - Browser code Find out the files managed by an Upload control.
    New in version 15
    WEBDEV - Server codeWEBDEV - Browser code Find out the files managed by an Upload control.
    WEBDEV - Server codeWEBDEV - Browser code Find out the files managed by an Upload control.
  • Versions 22 and later
    WEBDEV - Server codeWEBDEV - Browser codePHP Find out and modify the plane currently displayed in a Sliding Banner control.
    New in version 22
    WEBDEV - Server codeWEBDEV - Browser codePHP Find out and modify the plane currently displayed in a Sliding Banner control.
    WEBDEV - Server codeWEBDEV - Browser codePHP Find out and modify the plane currently displayed in a Sliding Banner control.
  • WEBDEV - Server codeWEBDEV - Browser code Center the map found in a Map control on a specific position.
  • Versions 18 and later
    WEBDEV - Server codeWEBDEV - Browser codePHP Find out and modify the lower value of the interval currently selected in a Range Slider control.
    New in version 18
    WEBDEV - Server codeWEBDEV - Browser codePHP Find out and modify the lower value of the interval currently selected in a Range Slider control.
    WEBDEV - Server codeWEBDEV - Browser codePHP 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: The Property Value is rarely used and can be replaced by an equivalent syntax (see Remarks).
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
WEBDEV - Server codePHPAjax

Value of Static control

The Property Value allows to retrieve or modify the text of an Static control.
<Result> is a character string.
To retrieve the text of a Static control, the following syntaxes are equivalent:
0
ResLibel = <control Libellé>
0
WEBDEV - Server code

Value of Calculated control in a report

The Property Value allows to retrieve or modify the value of a calculated field in an 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:
0

ResValue = <Control Calculé>
WEBDEV - Server codePHPAjax

Value of Bar Code control

The Property Value allows to retrieve or modify the value of an 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:
0

ResValue = <control Code-barres>
WEBDEV - Server codePHPAjax

Value of Image control

The Property Value allows you to know or 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:
0

ResImage = <control Image>
WEBDEV - Server code

Value of Static control or preset control found in a report

The Property Value allows you to know or modify the contents of the Control.
In assignment, the type of the value passed to the Property Value depends on the type of the Item associated to the control.
If the field is of the numeric type, it is necessary to assign a number to it while checking that the input mask is suitable (Property InputMask).
A date must be assigned to a Date control.
WEBDEV - Server codePHPAjax

Value of RTF control

The Property Value makes it possible to retrieve or modify the content of an Control RTF. 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:
0

ResRTF = <Control RTF>
WEBDEV - Server codePHPAjax

Value of window or page

The Property Value allows to retrieve or modify the title of a window or a page.
<Result> is a character string.
The Property Value is equivalent to the Property 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
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of edit control

The Property Value allows to retrieve or modify the value entered 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:
0

ResValue = <control de saisie>
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of Button control

The Property Value allows to retrieve or modify the text of an 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 Property Value is equivalent to the Property Libellé.
To know the text of a Button control, use one of the following syntaxes:
0

ResButton = <Control Bouton>

0
WEBDEV - Browser code On an Button control Image without Image overflight, the Value property allows 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

The Property Value allows 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:
0

0

ResChecked = <Option name>.Value

ResChecked = <Option name>
Remark: If <Option number> is not specified, the first option is selected by default.
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of Radio Button control

The Property Value allows 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:
0

ResOption = <Control Sélecteur>
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
WEBDEV - Server codePHPAjax

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 ("").
    The Property Value allows to:
    • Find out the selected row. If no row is selected, the Value property 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.
    0. If no row is selected, the Value property returns an Void 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
WEBDEV - Server code Reminder: the ListView control is not available for WEBDEV.
WEBDEV - Server codePHPAjax

Value of cell in a Table control

The Property Value allows to know or modify the value of a cell of an Table control.
<Result> is a character string.
To find out the value of a cell, use one of the following syntaxes:
0

0

0

0
Special case: Value of cell in the current row
If only the column name is specified, the Property Value allows:
  • 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>
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of Combo Box control

Two distinct cases may occur.
  • The Combo Box control is editable AND StoredItem corresponds to an empty string ("").
    The Property Value allows to:
    • Find out the value of selected item. If no item is selected, the Property Value returns a string Void ("").
      To find out the value of the selected element, use one of the following syntaxes:
      0

      ResValue = <Control Combo Box>
    • Modify the value of the selected element.
  • The Combo Box is not editable OR StoredItem is not empty.
    The Property Value allows you to know the number of the selected item.
    To find out the number of the selected element, use one of the following syntaxes:
    0
    0
    ResElement = <Control Combo Box>
WEBDEV - Browser code

Value of Tab control

The Property Value is used to find out the number of the Active tab or to activate an Tab control tab.
<Result> is an integer.
To find out the number of the active tab pane, use one of the following syntaxes:
0

ResVolet = <Control Onglet>
WEBDEV - Browser code The Property Value allows you to know the number of the Active tab in Browser code.
WEBDEV - Server codePHPAjax

Value of Chart control

The Property Value only allows to know the name of an Chart control.
<Result> is a character string.
To find out the name of a Chart control, use one of the following syntaxes:
0

Res_NomGraph = <Control Graphe>
WEBDEV - Server codeWEBDEV - Browser code

Value of Rating control

The Property Value allows to initialize and to know the value of an Rating control.
This value corresponds to the number of "pictograms" displayed in the control.
Example:
RATE_Nation1.Value = 4.5
WEBDEV - Browser code

Value of Drawer control

The Property Value allows to know if the Drawer control is unwound (1) or wound up (0) and allows to modify its report.
Example:
// Collapses the Drawer control if it is expanded
IF DRW_Drawer1.Value = 1 THEN DRW_Drawer1.Value = 0
WEBDEV - Server codeAjax

Value of HTML control

The Property Value allows to know 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
WEBDEV - Server codeWEBDEV - Browser code

Value of Map control

The Property Value allows to center the card (present in an Map control) on the position corresponding to an Variable of type geoPosition.
Example:
// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
 
MAP_Position.Value = MyPosition
Remarks:
  • The use of Property Value is equivalent to the function MapDisplayPosition. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
  • WEBDEV - Server code The Property Value allows only to modify the position in an Map control.
  • WEBDEV - Browser code The Property Value allows to know and modify the position in an Map control.
New in version 17
WEBDEV - Server codeWEBDEV - Browser code

Value of Map control

The Property Value allows to center the card (present in an Map control) on the position corresponding to an Variable of type geoPosition.
Example:
// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
 
MAP_Position.Value = MyPosition
Remarks:
  • The use of Property Value is equivalent to the function MapDisplayPosition. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
  • WEBDEV - Server code The Property Value allows only to modify the position in an Map control.
  • WEBDEV - Browser code The Property Value allows to know and modify the position in an Map control.
WEBDEV - Server codeWEBDEV - Browser code

Value of Map control

The Property Value allows to center the card (present in an Map control) on the position corresponding to an Variable of type geoPosition.
Example:
// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
 
MAP_Position.Value = MyPosition
Remarks:
  • The use of Property Value is equivalent to the function MapDisplayPosition. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
  • WEBDEV - Server code The Property Value allows only to modify the position in an Map control.
  • WEBDEV - Browser code The Property Value allows to know and modify the position in an Map control.
WEBDEV - Server codePHPAjax

Value of Site Map Path control

The Property Value is used to find out the subscript of the Breadcrumb control element on which the user has clicked.
WEBDEV - Server codePHPAjax

Button, Link and iFrame: Property URL and Property Value

Property URL has the same effect as Property Value on the Button, Link and iFrame fields. These properties are used to find out the address associated with the control.
Versions 15 and later
WEBDEV - Server codeWEBDEV - Browser codeAjax

Upload control

The Property Value allows you to know the HEX@ of the 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.
WEBDEV - Server code 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.
WEBDEV - Browser code The name of the files corresponds to the name of the file displayed on he browser. For example: MyImage.jpg
New in version 15
WEBDEV - Server codeWEBDEV - Browser codeAjax

Upload control

The Property Value allows you to know the HEX@ of the 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.
WEBDEV - Server code 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.
WEBDEV - Browser code The name of the files corresponds to the name of the file displayed on he browser. For example: MyImage.jpg
WEBDEV - Server codeWEBDEV - Browser codeAjax

Upload control

The Property Value allows you to know the HEX@ of the 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.
WEBDEV - Server code 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.
WEBDEV - Browser code The name of the files corresponds to the name of the file displayed on he browser. For example: MyImage.jpg
Versions 18 and later

WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Range Slider control

The Value property allows to know and modify the lower bound of the interval currently selected in an Slider control of interval. In this case, this property is equivalent to LowerValue.
The same rules apply.
New in version 18

WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Range Slider control

The Value property allows to know and modify the lower bound of the interval currently selected in an Slider control of interval. In this case, this property is equivalent to LowerValue.
The same rules apply.

WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Range Slider control

The Value property allows to know and modify the lower bound of the interval currently selected in an Slider control of interval. In this case, this property is equivalent to LowerValue.
The same rules apply.
Versions 22 and later

WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of Sliding Banner control

La Property Value permet de:
  • 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:
0

ResPlan = <Champ Bandeau Scrolling>
New in version 22

WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of Sliding Banner control

La Property Value permet de:
  • 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:
0

ResPlan = <Champ Bandeau Scrolling>

WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Value of Sliding Banner control

La Property Value permet de:
  • 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:
0

ResPlan = <Champ Bandeau Scrolling>

Limits

WEBDEV - Server code For states, the Property 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.
WEBDEV - Server codeWEBDEV - Browser code The Property Value cannot be used on:
  • an option in a radio button,
  • a group of controls.
WEBDEV - Browser code The Property Value works only on the following fields:
  • Static control.
  • Formatted display control.
  • Button control.
  • Edit control,
  • List Box control.
  • Combo Box,
  • Check Box control.
  • Radio Button 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.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment