Difference between revisions of "API Component.Property.SetListItem"
From Flowcode Help
Jump to navigationJump to search (XML import) |
|||
| (6 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | <sidebar>API | + | <sidebar>API Contents</sidebar> |
Sets an existing list entries text for the property by named index | Sets an existing list entries text for the property by named index | ||
| Line 11: | Line 11: | ||
==Parameters== | ==Parameters== | ||
| − | [[Variable | + | [[Variable Types|HANDLE]] ''Handle'' |
:The component handle to alter the property of | :The component handle to alter the property of | ||
| − | [[Variable | + | [[Variable Types|STRING]] ''Property'' |
:The textual name of the property | :The textual name of the property | ||
| − | [[Variable | + | [[Variable Types|STRING]] ''Index'' |
:The text or integer entry of the property | :The text or integer entry of the property | ||
| − | [[Variable | + | [[Variable Types|STRING]] ''Value'' |
:The value to update the entry with | :The value to update the entry with | ||
==Return value== | ==Return value== | ||
| − | [[Variable | + | [[Variable Types|BOOL]] |
| + | |||
Returns true if the operation is a success, else false | Returns true if the operation is a success, else false | ||
==Detailed description== | ==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 [[API Component.Property.GetListIndex|GetListIndex]]. | ||
| + | |||
| + | To add the line to the list regardless of whether it exists, use [[API Component.Property.AddListItem|AddListItem]]. | ||
==Examples== | ==Examples== | ||
| Line 38: | Line 47: | ||
* 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> | ||
| − | ''<span style="color:red;">No additional | + | ''<span style="color:red;">No additional examples</span>'' |
Latest revision as of 23:43, 28 January 2014
<sidebar>API Contents</sidebar> Sets an existing 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 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")
No additional examples
