Difference between revisions of "API Component.Property.GetListItem"

From Flowcode Help
Jump to navigationJump to search
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<sidebar>API contents</sidebar>
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
Gets a single list entry from a property by named index
+
|-
 
+
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
<div style="width:25%; float:right" class="toc">
+
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetListItem'''
====Class hierarchy====
+
|-
[[API Component|Component]]
+
| colspan="2" | Gets a single list entry from a property by named index&nbsp;
:[[API Component.Property|Property]]
+
|-
::[[API Component.Property|GetListItem]]
+
|-
</div>
+
| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
__TOC__
+
| width="90%" | Handle
 
+
|-
==Parameters==
+
| colspan="2" | The component handle to get the property of&nbsp;
[[Variable Types|HANDLE]] ''Handle''
+
|-
:The component handle to get the property of
+
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
 
+
| width="90%" | Property
[[Variable Types|STRING]] ''Property''
+
|-
:The textual name of the property
+
| colspan="2" | The textual name of the property&nbsp;
 
+
|-
[[Variable Types|STRING]] ''Index''
+
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
:The text or integer entry of the property
+
| width="90%" | Index
 
+
|-
 
+
| colspan="2" | The text or integer entry of the property&nbsp;
==Return value==
+
|-
[[Variable Types|STRING]]
+
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-string-icon.png]] - STRING
 
+
| width="90%" style="border-top: 2px solid #000;" | ''Return''
Returns the single list entry from a property by named index
+
|}
  
  
Line 31: Line 31:
  
  
Note the ''Index'' is not the line of the list to extract, but the 3-digit identifier. Ifmultiple lines have the same identifier this will extract the first found.
+
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.
  
  
Line 41: Line 41:
 
* Declare a variable 'result' of type STRING
 
* Declare a variable 'result' of type STRING
 
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.Property.GetListItem(handle, "property", "index")</pre>
 
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.Property.GetListItem(handle, "property", "index")</pre>
 
''<span style="color:red;">No additional information</span>''
 

Latest revision as of 11:54, 16 January 2023

Fc9-comp-macro.png GetListItem
Gets a single list entry from a property by named index 
Fc9-h32-icon.png - HANDLE Handle
The component handle to get the property of 
Fc9-string-icon.png - STRING Property
The textual name of the property 
Fc9-string-icon.png - STRING Index
The text or integer entry of the property 
Fc9-string-icon.png - STRING Return


Detailed description

Gets the text part of a list property identified by its 3-digit Index'.


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.


Examples

Calling in a calculation

  • Declare a variable 'result' of type STRING
  • Add to a calculation icon:
    result = ::Component.Property.GetListItem(handle, "property", "index")