Updates the value of a specified property for an object and returns the current value.
OrigValue = Set_Property( Object, Property, NewValue, Index )
| Name | Required | Description |
|---|---|---|
| Object | Yes | Identifier of the object to access. Must be in upper-case. |
| Property | Yes | Name of the property to access. Must be in upper-case. |
| NewValue | Yes | New value for the property. Can be null. |
| Index | No | If the property supports indexing then this parameter specifies the index value(s). Indexed properties can have one or two dimensions – if the latter then the dimensions are @fm-delimited. <1> First dimension <2> Second dimension The actual index value themselves are specific to the property in question. In most cases they will be numeric, but some properties can handle quoted text values as well. |
Returns the current property value. If an invalid object or property name is specified then no update occurs and an empty string (null) is returned. No error condition is flagged.
N/A
Set_Property supports the property concatenation interface described in Appendix A – Concatenating Properties.
* // Set the text of the current window OrigText = Set_Property( @Window, "TEXT", NewText ) * // Set the current value of the RBN_GENDER radiobutton group on the * // current window OrigGender = Set_Property( @Window : ".RBN_GENDER", "VALUE", "M" ) * // Set the text of the third tab for TAB_MAIN using a numeric index OrigText = Set_Property( @Window : ".TAB_MAIN.TABS", "TEXT", "Events", 3 ) * // Set the value of the "Events" tab for TAB_MAIN using a literal index OrigText = Set_Property( @Window : ".TAB_MAIN.TABS", "VALUE", "E", "Events" )