API Component.Property.SetListItem: Difference between revisions

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")

@@ Line 1: / Line 1: @@
+{| class="mtx-class-macrotable wikitable"
+|-
-<sidebar>API Contents</sidebar>
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-Sets an existing list entries text for the property by named index
+| width="90%" class="mtx-class-macrohead" | '''SetListItem'''
+|-
-<div style="width:25%; float:right" class="toc">
+| colspan="2" | Sets an existing list entries text for the property by named index&nbsp;
-====Class hierarchy====
+|-
-[[API Component|Component]]
+|-
-:[[API Component.Property|Property]]
+| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
-::[[API Component.Property|SetListItem]]
+| width="90%" | Handle
-</div>
+|-
-__TOC__
+| colspan="2" | The component handle to alter the property of&nbsp;
+|-
-==Parameters==
+| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
-[[Variable Types|HANDLE]] ''Handle''
+| width="90%" | Property
-:The component handle to alter the property of
+|-
+| colspan="2" | The textual name of the property&nbsp;
-[[Variable Types|STRING]] ''Property''
+|-
-:The textual name of the property
+| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
+| width="90%" | Index
-[[Variable Types|STRING]] ''Index''
+|-
-:The text or integer entry of the property
+| colspan="2" | The text or integer entry of the property&nbsp;
+|-
-[[Variable Types|STRING]] ''Value''
+| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
-:The value to update the entry with
+| width="90%" | Value
+|-
+| colspan="2" | The value to update the entry with&nbsp;
-==Return value==
+|-
-[[Variable Types|BOOL]]
+| 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''
-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.
+Sets the text part of a list property identified by its 3-digit ''Index''. If the line does not exist this call fails.
@@ Line 43: / Line 43: @@
 To add the line to the list regardless of whether it exists, use [[API Component.Property.AddListItem|AddListItem]].
 ==Examples==
@@ Line 50: / Line 48: @@
 * 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>
-''<span style="color:red;">No additional examples</span>''

SteveT (talk | contribs)

Latest revision as of 14:11, 13 July 2026

Detailed description

Examples

Calling in a calculation