ardi::item::text

Interact with items of type text.

Supported property names are: -name -value -parent -type (read only). All properties available can be passed via the "create" API or modified on an existing item via the "set" API.

ardi::item::text create args

Creates an item of type "text".
Parameters
For a full list of property names, see above.
Returns
The ID of the item or tcl-error in case an error occurred during creation. i.e ardi::api::item::text create -name "My Text Item"

ardi::item::text delete args

Deletes the item with the specified ID.
Parameters
-id (mandatory)
value: item ID. The item ID which is returned by the corresponding "create" API.
default value: ""
Returns
1 for ok
tcl-error in case of error i.e ardi::api::item::text delete -id $id

ardi::item::text get args

Queries the value of one property.
Parameters
-id (mandatory)
value: item ID. The item ID which is returned by the corresponding "create" API.
default value: ""
For a full list of property names, see above.
Returns
The value of the specified property or tcl-error in case of error usage: ardi::item::text get -id $id -property parent

ardi::item::text getpropertyid args

Queries id of property.
Parameters
-id
value: item ID
-key
value: property key

ardi::item::text getpropertykeylist args

Queries list of properties.
Parameters
-id
value: item ID
Returns
list of property keys for a particular item ID

ardi::item::text set args

Sets one or multiple parameters to specified values. The type of the item is assigned upon creation and cannot be changed after.
Parameters
-id (mandatory)
value: item ID. The item ID which is returned by the corresponding "create" API.
default value: ""
For a full list of property names, see above.
Returns
1 for ok
tcl-error in case of error i.e ardi::api::item::text set -id $id -name "My Text Item" -value "Good morning, how are you today?"