DeepCopy (ScreenField function): Difference between revisions
Jump to navigation
Jump to search
m (AllowNullObject methods) |
mNo edit summary |
||
| (2 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{Template:ScreenField:DeepCopy subtitle}} | {{Template:ScreenField:DeepCopy subtitle}} | ||
The <var>DeepCopy</var> method returns a <var>ScreenField</var> object that is a [[Copying objects|deep copy]] of the method object. Since a <var>ScreenField</var> cannot exist without its underlying <var>Screen</var>, a <var>ScreenField</var> is deep copyable only, and no <var>Copy</var> method exists for a <var>ScreenField</var>. | |||
==Syntax== | ==Syntax== | ||
{{Template:ScreenField:DeepCopy syntax}} | {{Template:ScreenField:DeepCopy syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%outSfield</th> | ||
<td>A declared ScreenField object. </td></tr> | <td>A declared <var>ScreenField</var> object.</td></tr> | ||
<tr><th> | <tr><th>sfield</th> | ||
<td>A reference to an instance of a ScreenField object, which may be <var>Null</var>.</td></tr> | <td>A reference to an instance of a <var>ScreenField</var> object, which may be <var>Null</var>.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | |||
<li>The method object (<var class="term">sfield</var>) may be <var>null</var>. The output of a copy of a <var>null</var> object is a <var>null</var> object. | |||
</ul> | |||
==See also== | ==See also== | ||
{{Template:ScreenField:DeepCopy footer}} | {{Template:ScreenField:DeepCopy footer}} | ||
Latest revision as of 17:59, 20 November 2012
Return a deep copy of a screenfield object (ScreenField class)
The DeepCopy method returns a ScreenField object that is a deep copy of the method object. Since a ScreenField cannot exist without its underlying Screen, a ScreenField is deep copyable only, and no Copy method exists for a ScreenField.
Syntax
%outSfield = sfield:DeepCopy
Syntax terms
| %outSfield | A declared ScreenField object. |
|---|---|
| sfield | A reference to an instance of a ScreenField object, which may be Null. |
Usage notes
- The method object (sfield) may be null. The output of a copy of a null object is a null object.