Difference between revisions of "API Component.Property.AddListItem"
From Flowcode Help
Jump to navigationJump to search (XML Import to change Variable types into Variable Types) |
|||
| Line 31: | Line 31: | ||
==Detailed description== | ==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]]. | ||
| + | |||
Revision as of 23:08, 11 June 2013
<sidebar>API contents</sidebar> Alters or appends a list entries text for the property by named index
Contents
Parameters
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
Return value
Returns true if the operation is a success, else false
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")
No additional information
