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.