/*
* The Mana World
* Copyright 2004 The Mana World Development Team
*
* This file is part of The Mana World.
*
* The Mana World is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* any later version.
*
* The Mana World is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with The Mana World; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* $Id$
*/
#ifndef _TMW_WINDOW_H__
#define _TMW_WINDOW_H__
#include <guichan/widgets/window.hpp>
#include <guichan/rectangle.hpp>
#include "../guichanfwd.h"
class ConfigListener;
class Image;
class ImageRect;
class WindowContainer;
/**
* A window. This window can be dragged around and has a title bar.
*
* \ingroup GUI
*/
class Window : public gcn::Window
{
public:
friend class WindowConfigListener;
/**
* Constructor. Initializes the title to the given text and hooks
* itself into the window container.
*
* @param text The initial window title, "Window" by default.
* @param modal Block input to other windows.
* @param parent The parent window. This is the window standing above
* this one in the window hiearchy. When reordering,
* a window will never go below its parent window.
*/
Window(const std::string &caption = "Window", bool modal = false,
Window *parent = NULL);
/**
* Destructor.
*/
~Window();
/**
* Sets the window container to be used by new windows.
*/
static void setWindowContainer(WindowContainer *windowContainer);
/**
* Draws the window.
*/
void draw(gcn::Graphics *graphics);
/**
* Adds a widget to the window.
*/
void add(gcn::Widget *w);
/**
* Adds a widget to the window and also specifices its position.
*/
void add(gcn::Widget *w, int x, int y);
/**
* Sets the width of the window contents.
*/
void setContentWidth(int width);
/**
* Sets the height of the window contents.
*/
void setContentHeight(int height);
/**
* Sets the location relative to the given widget.
*/
void setLocationRelativeTo(gcn::Widget* widget);
/**
* Sets the size of this window.
*/
void setContentSize(int width, int height);
/**
* Sets whether of not the window can be resized.
*/
void setResizable(bool resize);
/**
* Returns whether the window can be resized.
*/
bool isResizable();
/**
* Sets the minimum width of the window.
*/
void setMinWidth(unsigned int width);
/**
* Sets the minimum height of the window.
*/
void setMinHeight(unsigned int height);
/**
* Sets the maximum width of the window.
*/
void setMaxWidth(unsigned int width);
/**
* Sets the minimum height of the window.
*/
void setMaxHeight(unsigned int height);
/**
* Returns the parent window.
*
* @return The parent window or <code>NULL</code> if there is none.
*/
Window *getParentWindow();
/**
* Schedule this window for deletion. It will be deleted at the start
* of the next logic update.
*/
void scheduleDelete();
/**
* Window dragging and resizing mouse related. These methods also makes sure the
* window is not dragged/resized outside of the screen.
*/
void mousePress(int x, int y, int button);
void mouseMotion(int mx, int my);
void mouseRelease(int x, int y, int button);
/**
* The position of the resize grip
*/
gcn::Rectangle getGripDimension();
/**
* set Window internal name
*/
void setWindowName(std::string name);
/**
* Get window internal name
*/
std::string getWindowName();
/**
* Read the X, Y, and Width and Height for resizables
* in the config based on its internal name.
* That function let the values set with set{X, Y, Height, width}()
* if no config value is found.
* Don't forget to set these default values and resizable before
* calling this function.
*/
void loadWindowState();
/**
* Set the default win pos and size.
* (which can be different of the actual ones.)
*/
void setDefaultSize(int defaultX, int defaultY,
int defaultWidth, int defaultHeight);
/**
* Reset the win pos and size to default.
* Don't forget to set defaults first.
*/
void resetToDefaultSize();
protected:
gcn::Container *chrome; /**< Contained container */
Window *parent; /**< The parent window */
std::string mWindowName; /**< Window internal name */
int snapSize; /**< Snap distance to window edge */
bool title; /**< Window has a title bar */
bool modal; /**< Window is modal */
bool resizable; /**< Window can be resized */
bool mMouseResize; /**< Window is being resized */
int minWinWidth; /**< Minimum window width */
int minWinHeight; /**< Minimum window height */
int maxWinWidth; /**< Maximum window width */
int maxWinHeight; /**< Maximum window height */
int defaultX, defaultY; /**< Default Win Pos and size */
int defaultWidth, defaultHeight;
/** The window container windows add themselves to. */
static WindowContainer* windowContainer;
/**
* The config listener that listens to changes relevant to all
* windows
*/
static ConfigListener *windowConfigListener;
static int instances; /**< Number of Window instances */
static ImageRect border; /**< The window border and background */
static Image *resizeGrip; /**< The grip to resize window */
};
#endif
