CustomDestroy is a method that is called once on every Screen/Entity instance when it is no longer needed. Any objects that are created in custom code (as opposed to objects added through Glue) need to be removed/destroyed in CustomDestroy.
Objects which are created in CustomInitialize or CustomActivity must be properly destroyed in CustomDestroy. There are two categories of objects which must be destroyed:
- Entities must have their Destroy method
- Objects added to the engine (like Sprites) must be removed from the engine
The following example shows a Sprite created in CustomInitialize, then later destroyed in CustomDestroy:
// At class scope:
mSprite = SpriteManager.AddSprite("redball.bmp", ContentManagerName);