||<< Index >>||
|kill field( obsolete and removed in FB 5.7.104 )||statement|
kill field handle&
handle&gets released, and the value in
handle&is thereafter no longer a valid handle.
kill fieldis commonly used with handles returned by
read field, but it can dispose of any kind of handle. However, you should specifically not use it to dispose of resources, regions, window controls, and other "standard" kinds of Macintosh objects which are created and managed by the MacOS. Instead, you should use the appropriate Toolbox routine (ReleaseResource, DisposeRgn, DisposeControl, etc.) to dispose of such objects.
kill fieldis similar to the Toolbox call
DisposeHandle, except that it (like the
DisposeHstatement) checks for
_nilhandles and sets the
handle&variable to zero.