API Component.Delete: Difference between revisions

Latest revision as of 14:11, 13 July 2026

	Delete
Deletes an existing object, removing it from the panel
- HANDLE	Target
The object to delete
- BOOL	Return

Detailed description

This deletes a component.

Root components and component definitions may not be deleted. All other components may be deleted.

The components memory may not be freed immediately. The system will queue deleted components and erase the memory when the component is not referenced. Therefore a component may delete itself in its own event macro and safely complete processing.

Examples

Calling in a calculation

Declare a variable 'result' of type BOOL
Add to a calculation icon:
```
result = ::Component.Delete(target)
```

@@ Line 1: / Line 1: @@
-<sidebar>API contents</sidebar>
+{| class="mtx-class-macrotable wikitable"
-Deletes an existing object, removing it from the panel
+|-
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''Delete'''
+|-
+| colspan="2" | Deletes an existing object, removing it from the panel&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
+| width="90%" | Target
+|-
+| colspan="2" | The object to delete&nbsp;
+|-
+| 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''
+|}
-<div style="width:25%; float:right" class="toc">
-====Class hierarchy====
-[[API Component|Component]]
-:[[API Component|Delete]]
-</div>
-__TOC__
-==Parameters==
-[[Variable types|HANDLE]] ''Target''
-:The object to delete
+==Detailed description==
+This deletes a component.
-==Return value==
-[[Variable types|BOOL]]
-''<span style="color:red;">No additional information</span>''
+Root components and component definitions may not be deleted. All other components may be deleted.
-==Detailed description==
+The components memory may not be freed immediately. The system will queue deleted components and erase the memory when the component is not referenced. Therefore a component may delete itself in its own event macro and safely complete processing.
-''<span style="color:red;">No additional information</span>''
@@ Line 28: / Line 31: @@
 * Declare a variable 'result' of type BOOL
 * Add to a calculation icon: <pre class="brush:[cpp]">result = ::Component.Delete(target)</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