Replace command

Replaces one or more controls on a page.

replace <control-type> to=<string>
[id=<string>]
[at=<int>]
property1=value
property2=value
...

Description#

replace command replaces one or more controls on a page with a new control or a tree. It subsequently executes clean and then add commands as a single "transaction" which helps avoid flickering when clean and add executed separately.

Examples#

replace text to=header value="Welcome back!"

This command removes all children of header control and then adds a new text control.

Parameters#

control-type#

The type of the control.

id#

Control ID. ID will be auto-generated if not specified. If you need to get generated ID replace add command with addr which means "add with result", for example in Bash:

to#

Parent control ID.

at#

Replace control at the specified position in the children collection.