API Component.Property.SetChildValues: Difference between revisions

Latest revision as of 14:11, 13 July 2026

	SetChildValues
Sets all child components property as a string
- HANDLE	Parent
The owning component whose children will all be written to
- STRING	Property
The textual name of the property
- STRING	Value
The value to update the properties text with
- NONE	Return

Detailed description

This call steps through all the children of the component and sets the property specified in each to the given value. It is useful for updating a property in all the children of a group, for example.

Note this does not step through the children of compiled components, only those 'owned' by the Parent.

Examples

Calling in a calculation

Add to a calculation icon:

::Component.Property.SetChildValues(parent, "property", "value")

@@ Line 1: / Line 1: @@
-<sidebar>API contents</sidebar>
+{| class="mtx-class-macrotable wikitable"
-Sets all child components property as a string
+|-
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''SetChildValues'''
+|-
+| colspan="2" | Sets all child components property as a string&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
+| width="90%" | Parent
+|-
+| colspan="2" | The owning component whose children will all be written to&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
+| width="90%" | Property
+|-
+| colspan="2" | The textual name of the property&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-string-icon.png]] - STRING
+| width="90%" | Value
+|-
+| colspan="2" | The value to update the properties text with&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - NONE
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
-<div style="width:25%; float:right" class="toc">
-====Class hierarchy====
-[[API Component|Component]]
-:[[API Component.Property|Property]]
-::[[API Component.Property|SetChildValues]]
-</div>
-__TOC__
-==Parameters==
+==Detailed description==
-[[Variable types|HANDLE]] ''Parent''
+This call steps through all the children of the component and sets the property specified in each to the given value. It is useful for updating a property in all the children of a group, for example.
-:The owning component whose children will all be written to
-[[Variable types|STRING]] ''Property''
-:The textual name of the property
-[[Variable types|STRING]] ''Value''
-:The value to update the properties text with
-==Return value==
-''This call does not return a value''
-==Detailed description==
+Note this does not step through the children of compiled components, only those 'owned' by the ''Parent''.
-''<span style="color:red;">No additional information</span>''
@@ Line 31: / Line 37: @@
 ===Calling in a calculation===
 * Add to a calculation icon: <pre class="brush:[cpp]">::Component.Property.SetChildValues(parent, "property", "value")</pre>
-''<span style="color:red;">No additional information</span>''

SteveT (talk | contribs)

Latest revision as of 14:11, 13 July 2026

Detailed description

Examples

Calling in a calculation