|
DocumentTools[SetProperty] - Set property of an embedded component
|
|
Calling Sequence
|
|
SetProperty(id, attr, val, refreshopt)
|
|
|
Parameters
|
|
|
id
|
-
|
name ; name of embedded component
|
|
attr
|
-
|
name ; property of the component that is to be set
|
|
val
|
-
|
(optional) anything ; value of property to set
|
|
refreshopt
|
-
|
expression of the form refresh = value, where value is true or false; specifies whether or not to immediately update the document
|
|
|
|
|
|
Description
|
|
|
•
|
The SetProperty function sets the value of a property of an embedded component.
|
|
•
|
If the val option is omitted, the referenced component is reset to its default value.
|
|
•
|
By default, when this command is invoked from inside the code which is executed as the action of another embedded component, the document is not updated until that code terminates. The option refresh = true (or just refresh) can be used to force the document to update during the call to SetProperty.
|
|
|
|
Examples
|
|
Suppose that your document has a slider component with the name Slider1. To set the position of this slider to  th of its maximum (assuming the range is the default of 0..100) , you can do this:
|
>
|
|
|
>
|
|
Suppose your document has a plot component with the name Plot0. To display a single plot in the component, use the following commands.
|
>
|
|
|
>
|
|
To display an array of plots in the plot component, you must force the array to stay unsimplified by referring to it with quotes. See the specific component help page for any other special input instructions.
|
>
|
|
|
>
|
)](/support/helpjp/helpview.aspx?si=4189/file01478/math142.png)
|
|
>
|
|
If code attached to a button causes several other embedded component values to change, you would normally not want the document to update until all those changes have been made. If you want to force updating after each change, use the refresh = true option (which can be abbreviated as just refresh). For example the following code illustrates updating a series of ComboBox elements. It is assumed that this code is attached to a Button component.
|
>
|
![for i to 10 do s := NewList(i); DocumentTools:-SetProperty(ComboBox || i, 'itemList', s); DocumentTools:-SetProperty(ComboBox || i, 'value', s[1], refresh) end do](/support/helpjp/helpview.aspx?si=4189/file01478/math164.png)
|
|
|
Download Help Document
Was this information helpful?
