Difference between revisions of "API Component.Property.AddListItem"
From Flowcode Help
Jump to navigationJump to search (XML import API auto-gen) |
|||
| (21 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | |
| − | Alters or appends a list entries text for the property by named index | + | |- |
| + | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
| + | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''AddListItem''' | ||
| + | |- | ||
| + | | colspan="2" | Alters or appends a list entries text for the property by named index | ||
| + | |- | ||
| + | |- | ||
| + | | width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE | ||
| + | | width="90%" | Handle | ||
| + | |- | ||
| + | | colspan="2" | The component handle to alter the property of | ||
| + | |- | ||
| + | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING | ||
| + | | width="90%" | Property | ||
| + | |- | ||
| + | | colspan="2" | The textual name of the property | ||
| + | |- | ||
| + | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING | ||
| + | | width="90%" | Index | ||
| + | |- | ||
| + | | colspan="2" | The text or integer entry of the property | ||
| + | |- | ||
| + | | width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING | ||
| + | | width="90%" | Value | ||
| + | |- | ||
| + | | colspan="2" | The value to update the entry with | ||
| + | |- | ||
| + | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-bool-icon.png]] - BOOL | ||
| + | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
| + | |} | ||
| − | == | + | ==Detailed description== |
| − | '' | + | Sets the text part of a list property identified by its 3-digit ''Index'. If the line does not exist then a new line is appended to the list. |
| − | |||
| − | |||
| − | |||
| − | '' | + | 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 [[API Component.Property.GetListIndex|GetListIndex]]. | |
| − | [[ | ||
| − | |||
| − | + | To add the line to the list only if it exists, use [[API Component.Property.SetListItem|SetListItem]]. | |
| − | |||
| − | + | ||
| − | + | ||
| + | ==Examples== | ||
| + | ===Calling in a calculation=== | ||
* Declare a variable 'result' of type BOOL | * Declare a variable 'result' of type BOOL | ||
| − | * Add to a calculation icon: result = ::Component.Property.AddListItem(handle, "property", "index", "value") | + | * Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.Property.AddListItem(handle, "property", "index", "value")</pre> |
Latest revision as of 11:54, 16 January 2023
Error creating thumbnail: Unable to save thumbnail to destination
|
AddListItem |
| Alters or appends a list entries text for the property by named index | |
Error creating thumbnail: Unable to save thumbnail to destination - HANDLE
|
Handle |
| The component handle to alter the property of | |
Error creating thumbnail: Unable to save thumbnail to destination - STRING
|
Property |
| The textual name of the property | |
Error creating thumbnail: Unable to save thumbnail to destination - STRING
|
Index |
| The text or integer entry of the property | |
Error creating thumbnail: Unable to save thumbnail to destination - STRING
|
Value |
| The value to update the entry with | |
Error creating thumbnail: Unable to save thumbnail to destination - BOOL
|
Return |
Detailed description
Sets the text part of a list property identified by its 3-digit Index'. If the line does not exist then a new line is appended to the list.
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 only if it exists, use SetListItem.
Examples
Calling in a calculation
- Declare a variable 'result' of type BOOL
- Add to a calculation icon:
result = ::Component.Property.AddListItem(handle, "property", "index", "value")
