API Component.Property.SetListItem: Difference between revisions
No edit summary |
m Text replacement - "width="90%" style="background-color:#D8C9D8; color:#4B008D;"" to "width="90%" class="mtx-class-macrohead"" |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{| class="wikitable | {| class="mtx-class-macrotable wikitable" | ||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''SetListItem''' | ||
|- | |- | ||
| colspan="2" | Sets an existing list entries text for the property by named index | | colspan="2" | Sets an existing list entries text for the property by named index | ||
| Line 48: | Line 48: | ||
* Declare a variable 'result' of type BOOL | * Declare a variable 'result' of type BOOL | ||
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.Property.SetListItem(handle, "property", "index", "value")</pre> | * Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.Property.SetListItem(handle, "property", "index", "value")</pre> | ||
Latest revision as of 14:11, 13 July 2026
|
SetListItem |
| Sets an existing list entries text for the property by named index | |
 - HANDLE
|
Handle |
| The component handle to alter the property of | |
 - STRING
|
Property |
| The textual name of the property | |
| - STRING
|
Index |
| The text or integer entry of the property | |
| - STRING
|
Value |
| The value to update the entry with | |
 - BOOL
|
Return |
Detailed description
Sets the text part of a list property identified by its 3-digit Index. If the line does not exist this call fails.
Note the Index is not the line of the list to extract, but the 3-digit identifier. If multiple lines have the same identifier this will extract the first found.
To find the index from the line, use GetListIndex.
To add the line to the list regardless of whether it exists, use AddListItem.
Examples
Calling in a calculation
- Declare a variable 'result' of type BOOL
- Add to a calculation icon:
result = ::Component.Property.SetListItem(handle, "property", "index", "value")