VALUE property [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== VALUE property ======

 


 
==== Applies To ====
 
Radio button group, Tab control, Up-Down controls, Date and Time Picker controls, Progress Bar controls
 
==== Description ====
 
Returns or sets the value of a selected radio button or tab within a tab control.

This property specifies the current position of the Up-Down control.

This property specifies the current value of the Date and Time Picker control in the standard Revelation DateTime format of:

<date> : "." : <time>

Where date is the number of days elapsed since December 31, 1967, and time is the fraction (percentage) of the day that has elapsed.  While the TEXT property is supported the VALUE property should be used to access the Date and Time Picker date-time values to avoid possible complications with custom formatting strings.

For Progress Bar controls this simple integer property sets the current value (position) of the progress bar.  It should be a value between the limits set by the [[range|RANGE]] property.
 
==== Usage ====
 
//currentVal// = **Get_Property**(//objectname//, "**VALUE**")

//lastVal// = **Set_Property**(//objectname//, "**VALUE**", //newVal//)
 
==== Example ====
 

A radio button group control has the following settings:

{{radiobuttonprops.gif?422x384}}

The code below produces the following result

<code>
declare function Get_Property

declare subroutine Set_Property

retval = Get_Property(@window : '.RADIO_1','VALUE')

/* retval contains the value 2 (for Undecided) */

Set_Property(@window : '.RADIO_1', 'VALUE', 0)

/* the first button, with value 0 (for Agree) is
selected. */
</code>