Method Dispose

source/script_gui.cpp:2222–2264

void GuiType::Dispose()
// Cleans up resources managed separately to the window.  This is separate from Destroy()
// for maintainability; i.e. to ensure resources are freed even if the window had not been
// successfully created.
{
	if (mDisposed)
		return;
	mDisposed = true;

	if (mBackgroundBrushWin)
		DeleteObject(mBackgroundBrushWin);
	if (mHdrop)
		DragFinish(mHdrop);
	
	// A partially constructed Gui can't have a non-zero mControlCount, but it seems more
	// appropriate to do this here than in Destroy():
	for (GuiIndexType u = 0; u < mControlCount; ++u)
	{
		mControl[u]->Dispose();
		mControl[u]->Release(); // Release() vs delete because the script may still have references to it.
	}
	// The following has been confirmed necessary to prevent the script from crashing if
	// the controls are being enumerated (e.g. by GuiTypeEnum) when the Gui is destroyed:
	mControlCount = 0;

	if (mMenu)
		mMenu->Release();

	mEvents.Dispose();
	if (mEventSink && this != mEventSink)
		mEventSink->Release();

	if (mIconEligibleForDestruction && mIconEligibleForDestruction != g_script.mCustomIcon) // v1.0.37.07.
		DestroyIconsIfUnused(mIconEligibleForDestruction, mIconEligibleForDestructionSmall);

	// For simplicity and performance, any fonts used *solely* by a destroyed window are destroyed
	// only when the program terminates.  Another reason for this is that sometimes a destroyed window
	// is soon recreated to use the same fonts it did before.

	RemoveAccelerators();
	free(mControl); // Free the control array, which was previously malloc'd.
	free(mName);
}


void GuiControlType::Dispose()