Difference between revisions of "API Component.FindChild"

From Flowcode Help
Jump to navigationJump to search
(XML import)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<sidebar>API contents</sidebar>
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
Finds a named object that is part of the component
+
|-
 
+
| 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;" | '''FindChild'''
====Class hierarchy====
+
|-
[[API Component|Component]]
+
| colspan="2" | Finds a named object that is part of the component&nbsp;
:[[API Component|FindChild]]
+
|-
</div>
+
|-
__TOC__
+
| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
 
+
| width="90%" | Current
==Parameters==
+
|-
[[Variable types|HANDLE]] ''Current''
+
| colspan="2" | Object to search children of&nbsp;
:Object to search children of
+
|-
:''The default value for this parameter is: '''''this'''
+
| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
 
+
| width="90%" | ChildName
[[Variable types|STRING]] ''ChildName''
+
|-
:Name of the child to search for
+
| colspan="2" | Name of the child to search for&nbsp;
 
+
|-
==Return value==
+
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-h32-icon.png]] - HANDLE
[[Variable types|HANDLE]]
+
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 
+
|}
''<span style="color:red;">No additional information</span>''
 
  
  
 +
==Detailed description==
 +
This call will search the components owned and in [[Component Tree#Scope|scope]] for the non-case sensitive ''ChildName''.
  
==Detailed description==
+
This call is unnecessary if 'this' is passed as ''Current'' and ''ChildName'' is a literal string. In this case it is more efficient to use the constant variable which will point to the child component.
''<span style="color:red;">No additional information</span>''
 
  
  
Line 32: Line 32:
 
* Declare a variable 'result' of type HANDLE
 
* Declare a variable 'result' of type HANDLE
 
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.FindChild(current, "childname")</pre>
 
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.FindChild(current, "childname")</pre>
 
''<span style="color:red;">No additional information</span>''
 

Latest revision as of 11:54, 16 January 2023

Fc9-comp-macro.png FindChild
Finds a named object that is part of the component 
Fc9-h32-icon.png - HANDLE Current
Object to search children of 
Fc9-string-icon.png - STRING ChildName
Name of the child to search for 
Fc9-h32-icon.png - HANDLE Return


Detailed description

This call will search the components owned and in scope for the non-case sensitive ChildName.

This call is unnecessary if 'this' is passed as Current and ChildName is a literal string. In this case it is more efficient to use the constant variable which will point to the child component.


Examples

Calling in a calculation

  • Declare a variable 'result' of type HANDLE
  • Add to a calculation icon:
    result = ::Component.FindChild(current, "childname")