TDESTROY Method [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== TDESTROY Method ======


 
==== Description ====
 
Method for destroying entities and entities used by this entity (such as a window and events created in the window).  Tdestroying a Window will destroy the window and events. Tdestroying a compiled window will destroy the window events and their compiled versions. Tdestroying a stored procedure executable (STPROCEXE) will destroy the source (STPROC) and debug (STPROCDBG) also.
 
==== Syntax ====
 
//object// = **Repository**('TDESTROY', //entID//)
 
==== Parameters ====
 
The TDESTROY method has the following parameters.

^Parameter^Description^
|//Message//|'TDESTROY'|
|//entID//|//entID// consists of four elements, which are '*' (asterisk) delimited:\\ \\ * Application name\\ * Type ID\\ * Class ID\\ * Entity name\\ \\ Methods are executed as follows:  if class specific, execute at the class level; if type specific, execute at the type level; otherwise, execute the method.|

 
==== Returns ====
 
null

**Note:**  Always call the [[get_status|Get_Status function]] after calling Repository.
 
==== See Also ====
 
[[repository|Repository() function]], [[destroy|DESTROY method]], [[get_repos_entities|Get_Repos_Entities()]]. Also, Stored Procedures chapter in the //Guide to Application Development//.
 
==== Example ====
 
<code>
* Destroy the BTREEREADTEST_BACKUP form, and entities used by it (window events) */

Declare Function Repository, Get_Status

AppID = @APPID<1>  ;* current application

TypeID = "OIWINEXE"  ;* OpenInsight window executable

ClassID = ""  ;* Not Applicable

Window_Name = 'BTREEREADTEST_BACKUP'

entid = AppID : '*' : TypeID : '*' : ClassID : '*' : Window_Name

result = Repository("TDESTROY",  entid)

/*  the form and its associated events have been destroyed */

*  test result

If Get_Status(ErrCode) then

   call msg(@window, 'Error Message returned: ' : ErrCode)

end
</code>