PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • 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 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 Multimedia control
  • Value of Map control
  • Value of stream
  • Value of Site Map Path control
  • Button, Link and iFrame: URL and Value properties
  • Upload control
  • Range Slider control
  • Value of Spreadsheet control
  • Value of Sliding Banner control
  • Limitations
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 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.
  • Windows Mobile Find out and modify the multimedia file linked to a Multimedia control.
  • Versions 22 and later
    PHP Find out and modify the plane currently displayed in a Sliding Banner control.
    New in version 22
    PHP Find out and modify the plane currently displayed in a Sliding Banner control.
    PHP Find out and modify the plane currently displayed in a Sliding Banner control.
  • AndroidiPhone/iPad Center the map found in a Map control on a specific position.
  • Versions 18 and later
    PHP Find out and modify the lower value of the interval currently selected in a Range Slider control.
    New in version 18
    PHP Find out and modify the lower value of the interval currently selected in a Range Slider control.
    PHP 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.
  • Versions 23 and later
    AndroidiPhone/iPad Find out the identifier or the handle associated with a Native Container control.
    New in version 23
    AndroidiPhone/iPad Find out the identifier or the handle associated with a Native Container control.
    AndroidiPhone/iPad 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).
Versions 15 and later
Android This property is now available for Android applications.
New in version 15
Android This property is now available for Android applications.
Android This property is now available for Android applications.
Versions 17 and later
iPhone/iPad This property is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for iPhone/iPad applications.
iPhone/iPad This property is now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for reports in iPhone/iPad applications.
Android Widget This property is now available in Android Widget mode.
New in version 18
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for reports in iPhone/iPad applications.
Android Widget This property is now available in Android Widget mode.
Universal Windows 10 App This property is now available in Windows Store apps mode.
iPhone/iPad This property is now available for reports in iPhone/iPad applications.
Android Widget This property is now available in Android Widget mode.
Versions 20 and later
AndroidiPhone/iPad This property is now available for Table controls and table columns in Android and iPhone/iPad applications.
New in version 20
AndroidiPhone/iPad This property is now available for Table controls and table columns in Android and iPhone/iPad applications.
AndroidiPhone/iPad This property is now available for Table controls and table columns in Android and iPhone/iPad applications.
Versions 21 and later
Apple Watch This property is now available in Apple Watch mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
New in version 21
Apple Watch This property is now available in Apple Watch mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Apple Watch This property is now available in Apple Watch mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
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
Universal Windows 10 AppWindows MobileAndroidAndroid Widget iPhone/iPadApple WatchJavaUser code (UMC)PHPAjax

Value of Static control

The Value property is used to retrieve or 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 = <Static control>.Value
ResCaption = <Static control>
ResCaption = <Static control>.Caption
Universal Windows 10 AppWindows MobileiPhone/iPad

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:
ResValue = <Calculated control>.Value

ResValue = <Calculated control>
Windows MobileUser code (UMC)PHPAjax

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:
ResValue = <Bar Code control>.Value

ResValue = <Bar Code control>
Universal Windows 10 AppWindows MobileAndroidAndroid Widget iPhone/iPadApple WatchJavaUser code (UMC)PHPAjax

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 = <Image control>.Value

ResImage = <Image control>
Universal Windows 10 AppWindows MobileiPhone/iPad

Value of Static 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.
Windows MobileUser code (UMC)PHPAjax

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 = <RTF control>.Value

ResRTF = <RTF control>
Universal Windows 10 AppWindows MobileAndroidAndroid Widget iPhone/iPadApple WatchJavaUser code (UMC)PHPAjax

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:
ResTitle = <Name of window or page>.Value

ResTitle = <Name of window or page>

ResTitle = <Name of window or page>.Title
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadApple WatchJavaUser code (UMC)PHPAjax

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 sub-type of 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:
ResValue = <Edit control>.Value

ResValue = <Edit control>
Universal Windows 10 AppWindows MobileAndroidAndroid Widget iPhone/iPadApple WatchJavaUser code (UMC)PHPAjax

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:
ResButton = <Button control>.Value

ResButton = <Button control>

ResButton = <Button control>.Caption

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
<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 = <Check Box control>[<Option number>].Value

ResChecked = <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.
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJavaUser code (UMC)PHPAjax

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 = <Radio Button control>.Value

ResOption = <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
Universal Windows 10 AppWindows MobileAndroidiPhone/iPadJavaUser code (UMC)PHPAjax

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 the StoredItem property corresponds to an empty string ("").
    The Value property is used to:
    • Find out 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:
      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 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:
    ResStoredItem = <Control name>.Value

    ResStoredItem = <Control name>.StoredItem
AndroidiPhone/iPad ListView controls are not available.
Windows MobileJavaUser code (UMC)PHPAjax

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:
ResCell = <Table control>[<Row number>][<Column number>].Value

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

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

ResCell = <Column>[<Row number>]
Special case: Value of cell in the current row
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:
ResColumn = <Column name>.Value

ResColumn = <Column name>
Windows MobileAndroidJavaUser code (UMC)PHPAjax

Value of Combo Box control

Two distinct cases may occur.
  • The Combo Box control is editable AND the StoredItem property corresponds 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:
      ResValue = <Combo Box control>.Value

      ResValue = <Combo Box control>
    • Modify the value of the selected element.
  • The Combo Box is not editable OR StoredItem 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:
    ResElement = <Combo Box control>.Value
    ResElement = <Combo Box control>[<Combo Box control>]
    ResElement = <Combo Box control>
Versions 19 and later
Windows MobileUser code (UMC)

Value of TreeView control or TreeView Table control

Two distinct cases may occur.
  • The control is memory control OR the StoredItem property corresponds to an empty string ("").
    The Value property is used to:
    • Find out 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:
      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 control is a browsing control 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:
    ResStoredItem = <Control name>.Value

    ResStoredItem = <Control name>.StoredItem
New in version 19
Windows MobileUser code (UMC)

Value of TreeView control or TreeView Table control

Two distinct cases may occur.
  • The control is memory control OR the StoredItem property corresponds to an empty string ("").
    The Value property is used to:
    • Find out 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:
      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 control is a browsing control 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:
    ResStoredItem = <Control name>.Value

    ResStoredItem = <Control name>.StoredItem
Windows MobileUser code (UMC)

Value of TreeView control or TreeView Table control

Two distinct cases may occur.
  • The control is memory control OR the StoredItem property corresponds to an empty string ("").
    The Value property is used to:
    • Find out 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:
      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 control is a browsing control 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:
    ResStoredItem = <Control name>.Value

    ResStoredItem = <Control name>.StoredItem
Windows MobileUser code (UMC)

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:
ResValue = <Control name>.Value

ResValue = <Control name>
Windows MobileJavaUser code (UMC)

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:
ResPane = <Tab control>.Value

ResPane = <Tab control>
Windows MobileUser code (UMC)

Value of menu or menu option

The Value property is used to determine the number associated with the current menu or menu option.
Remark: 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 = <Name of menu or menu option>.Value

ResMenu = <Name of menu or menu option>
Universal Windows 10 AppWindows MobileiPhone/iPadUser code (UMC)PHPAjax

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_ChartName = <Chart control>.Value

Res_ChartName = <Chart control>
User code (UMC)

Value of OLE control

The Value property is used to initialize an OLE control with an OLE object (equivalent to OLELoad).
Example:
OLE_OLE1.Value = "Test.OLE" // Equivalent to OLELoad("OLE_OLE1", "TestOLE")
AndroidiPhone/iPad

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:
RATE_Nation1.Value = 4.5
User code (UMC)

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:
// Collapses the Drawer control if it is expanded
IF DRW_Drawer1.Value = 1 THEN DRW_Drawer1.Value = 0
Windows MobileUser code (UMC)

Value of ActiveX control

The Value property is used to get the COM identifier (ProgId) of the ActiveX control being used.
Universal Windows 10 AppUser code (UMC)Ajax

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.
Universal Windows 10 App The Value property returns the URL of the site but cannot return the HTML code of the control. This property cannot be used to associate a local htm file with the HTML control.
Windows Mobile

Value of Multimedia control

The Value property is used to get the name of the multimedia file linked to a Multimedia control. This property can also be used to modify the multimedia file linked to the control:
  • The file specified by the Value property is associated with the control, loaded and played (equivalent to the MultimediaPlay function).
  • If the value of the control is an empty string (""), the read operation is stopped and the file is unloaded from memory.
Versions 17 and later
AndroidiPhone/iPad

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:
// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
 
MAP_Position.Value = MyPosition
Remarks:
  • The Value property is equivalent to the MapDisplayPosition function. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
New in version 17
AndroidiPhone/iPad

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:
// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
 
MAP_Position.Value = MyPosition
Remarks:
  • The Value property is equivalent to the MapDisplayPosition function. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
AndroidiPhone/iPad

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:
// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
 
MAP_Position.Value = MyPosition
Remarks:
  • The Value property is equivalent to the MapDisplayPosition function. The only difference is: when using MapDisplayPosition, the positioning on the requested position is performed via an animation.
User code (UMC)

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

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

Button, Link and iFrame: URL and Value properties

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.
Versions 15 and later
Ajax

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.
New in version 15
Ajax

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

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.
Versions 18 and later

PHPAjax

Range Slider control

The Value property is used to get and change 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.
New in version 18

PHPAjax

Range Slider control

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

PHPAjax

Range Slider control

The Value property is used to get and change 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.
Versions 20 and later
User code (UMC)

Value of Spreadsheet control

The Value property is used to get and modify the binary content of a Spreadsheet control.
For example:
PSHEET_Show.Value = fLoadBuffer(fExeDir() + "\Fashion Showxls")
New in version 20
User code (UMC)

Value of Spreadsheet control

The Value property is used to get and modify the binary content of a Spreadsheet control.
For example:
PSHEET_Show.Value = fLoadBuffer(fExeDir() + "\Fashion Showxls")
User code (UMC)

Value of Spreadsheet control

The Value property is used to get and modify the binary content of a Spreadsheet control.
For example:
PSHEET_Show.Value = fLoadBuffer(fExeDir() + "\Fashion Showxls")
Versions 22 and later

PHPAjax

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:
ResPlane = <Sliding Banner control>.Value

ResPlane = <Sliding Banner control>
New in version 22

PHPAjax

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:
ResPlane = <Sliding Banner control>.Value

ResPlane = <Sliding Banner control>

PHPAjax

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:
ResPlane = <Sliding Banner control>.Value

ResPlane = <Sliding Banner control>

Limitations

Universal Windows 10 AppWindows MobileiPhone/iPad 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.
  • Versions 21 and later
    a Signature control.
    New in version 21
    a Signature control.
    a Signature control.
WINDEV Mobile In a window, the Value property cannot be used on:
  • an option in a radio button.
  • a tab pane.
  • a group of controls.
Java The Value property only applies to the following elements:
  • Button.
  • Static control.
  • Edit control.
  • Image.
  • Check Box.
  • Radio Button.
  • List Box.
  • Combo Box.
  • Tab.
  • Window.
  • Table.
  • Table column.
  • Supercontrol.
Android Widget The Value property only applies to the following elements:
  • Button control.
  • Static control.
  • Image control.
  • Window.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment