Skip to main content

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.