Movable guiBitmapCtrl

Download Code File

I wasn't happy with the guiWindowCtrl, so I decided the easiest way to create a window was using the guiBitmapCtrl. The only thing I needed for it to act as a window was to make it movable. This is what this resource will do.

In the private section of guiBitmapCtrl.h add:

//JL - Movable Bitmaps
	bool mCanMove;
	bool mMouseMovingWin;
	Point2I mMouseDownPosition;

	RectI mOrigBounds;
	//JL - Movable Bitmaps

Add the following to public methods to guiBitmapCtrl.h:

// JL - Movable bitmap
   GuiControl* findHitControl(const Point2I &pt, S32 initialLayer = -1);

   void onMouseDown(const GuiEvent &event);
   void onMouseDragged(const GuiEvent &event);
	void onMouseUp(const GuiEvent &event);

   void selectWindow(void);
	// JL - Movable bitmap

On to the guiBitmapCtrl.cpp file add the following to the includes:

#include "gui/core/guiCanvas.h"

In the contructor (GuiBitmapCtrl::GuiBitmapCtrl(void)) add:

//JL - Moveable Bitmaps
	mCanMove = true;
   mMouseMovingWin = false;
	//JL - Moveable Bitmaps

Then I add the following to initPersistFields(). This will allow you to turn it the movability on and off in the GUI editor.

addField("canMove",           TypeBool,         Offset(mCanMove, GuiBitmapCtrl)); //JL - Movable Bitmaps

Then at the bottom of the guiBitmapCtrl.cpp file I paste the following methods/functions:

GuiControl* GuiBitmapCtrl::findHitControl(const Point2I &pt, S32 initialLayer)
{
	return Parent::findHitControl(pt, initialLayer);
}

void GuiBitmapCtrl::selectWindow(void)
{
   //first make sure this window is the front most of its siblings
   GuiControl *parent = getParent();
   if (parent)
   {
      parent->pushObjectToBack(this);
   }

   //also set the first responder to be the one within this window
   setFirstResponder(mFirstResponder);
}

void GuiBitmapCtrl::onMouseDown(const GuiEvent &event)
{
   setUpdate();

   mOrigBounds = mBounds;

   mMouseDownPosition = event.mousePoint;
   Point2I localPoint = globalToLocalCoord(event.mousePoint);

   //select this window - move it to the front, and set the first responder
   //selectWindow();

   GuiControl *ctrl = findHitControl(localPoint);
	if (ctrl && ctrl != this){
		mMouseMovingWin = false;
      ctrl->onMouseDown(event);
	}
	else {
		mMouseMovingWin = mCanMove;
		mouseLock();
	}

}

void GuiBitmapCtrl::onMouseDragged(const GuiEvent &event)
{
   GuiControl *parent = getParent();
   GuiCanvas *root = getRoot();
   if (!root) return;

   Point2I deltaMousePosition = event.mousePoint - mMouseDownPosition;

   Point2I newPosition = mBounds.point;
   Point2I newExtent = mBounds.extent;
	bool update = false;

   if (mMouseMovingWin && parent)
   {
      newPosition.x = getMax(0, getMin(parent->mBounds.extent.x - mBounds.extent.x, mOrigBounds.point.x + deltaMousePosition.x));
      newPosition.y = getMax(0, getMin(parent->mBounds.extent.y - mBounds.extent.y, mOrigBounds.point.y + deltaMousePosition.y));
      
		update = true;
   }

	if (update)
	{
		Point2I pos = parent->localToGlobalCoord(mBounds.point);
		root->addUpdateRegion(pos, mBounds.extent);
      Parent::resize(newPosition, newExtent);
	}

}

void GuiBitmapCtrl::onMouseUp(const GuiEvent &event)
{

   event;
   mouseUnlock();

   mMouseMovingWin = false;

}

Known Bugs: With the SelectWindow(); function uncommented it seems to loose everything when you dont click on the Image since it's bringing the Back to the front over everything. Not sure how to get around it.


It's pretty simple, I hope you find it usefull. Here's an example of the kind of "Windows" you can have (from Solar Battles) :