====== READONLY Property ======


 
==== Applies To ====
 
Editline, EditBox, RichTextBox
 
==== Description ====
 
A boolean property to set or retrieve the control's READONLY status.
 
==== Usage ====
 
readOnly = Get_Property(objectname,”READONLY”)

existingReadOnly = Set_Property(objectname,”READONLY”, bValue)
 
 
==== Remarks ====
 
Values passed in Set_Property():


^Value^Description^
|bValue|Boolean true (1) or false (0)|
 
==== Returns ====
 
Values returned by Get_Property and Set_Property

^Value^Description^
|readOnly|The Boolean status of the control’s READONLY status.|
|existingReadOnly|The Boolean status of the control’s READONLY status, when Set_Property was run.|
 
==== See Also ====
 
[[enabled|ENABLED property]]
 
==== Example ====
 
<code>
Declare function Get_Property, Set_Property

/* retrieve the current READONLY property of an editline and toggle to its Boolean opposite */

ctrlName = @window : ".EDITLINE_1"

readOnly = Get_Property(ctrlName,"READONLY")

if readOnly then

   readOnly = 0

end else

   readOnly = 1

end

eReadOnly = Set_Property(ctrlName,"READONLY",readOnly)
</code>