/*
* The ManaPlus Client
* Copyright (C) 2004-2009 The Mana World Development Team
* Copyright (C) 2009-2010 The Mana Developers
* Copyright (C) 2011 The ManaPlus Developers
*
* This file is part of The ManaPlus Client.
*
* This program 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.
*
* This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef WINDOW_H
#define WINDOW_H
#include "graphics.h"
#include "guichanfwd.h"
#include <guichan/widgetlistener.hpp>
#include <guichan/widgets/window.hpp>
#ifdef __GNUC__
#define _UNUSED_ __attribute__ ((unused))
#else
#define _UNUSED_
#endif
class ContainerPlacer;
class GraphicsVertexes;
class Layout;
class LayoutCell;
class ResizeGrip;
class Skin;
class WindowContainer;
/**
* A window. This window can be dragged around and has a title bar. Windows are
* invisible by default.
*
* \ingroup GUI
*/
class Window : public gcn::Window, gcn::WidgetListener
{
public:
/**
* Constructor. Initializes the title to the given text and hooks
* itself into the window container.
*
* @param caption 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.
* @param skin The location where the window's skin XML can be found.
*/
Window(const std::string &caption = "Window", bool modal = false,
Window *parent = NULL, const std::string &skin = "window.xml");
/**
* Destructor. Deletes all the added widgets.
*/
~Window();
/**
* Sets the window container to be used by new windows.
*/
static void setWindowContainer(WindowContainer *windowContainer);
/**
* Draws the window.
*/
void draw(gcn::Graphics *graphics);
/**
* Sets the size of this window.
*/
void setContentSize(int width, int height);
/**
* Sets the location relative to the given widget.
*/
void setLocationRelativeTo(gcn::Widget *widget);
/**
* Sets the location relative to the given widget (only horisontally)
*/
void setLocationHorisontallyRelativeTo(gcn::Widget *widget);
/**
* Sets the location relative to the given enumerated position.
*/
void setLocationRelativeTo(ImageRect::ImagePosition position,
int offsetX = 0, int offsetY = 0);
/**
* Sets whether or not the window can be resized.
*/
void setResizable(bool resize);
void redraw();
/**
* Called whenever the widget changes size.
*/
void widgetResized(const gcn::Event &event);
virtual void widgetMoved(const gcn::Event& event);
/**
* Called whenever the widget is hidden.
*/
virtual void widgetHidden(const gcn::Event& event);
/**
* Sets whether or not the window has a close button.
*/
void setCloseButton(bool flag);
/**
* Returns whether the window can be resized.
*/
bool isResizable() const;
/**
* Sets the minimum width of the window.
*/
void setMinWidth(int width);
int getMinWidth() const
{ return mMinWinWidth; }
/**
* Sets the minimum height of the window.
*/
void setMinHeight(int height);
int getMinHeight() const
{ return mMinWinHeight; }
/**
* Sets the maximum width of the window.
*/
void setMaxWidth(int width);
int getMaxWidth() const
{ return mMaxWinWidth; }
/**
* Sets the minimum height of the window.
*/
void setMaxHeight(int height);
int getMaxHeight() const
{ return mMaxWinHeight; }
/**
* Sets flag to show a title or not.
*/
void setShowTitle(bool flag)
{ mShowTitle = flag; }
/**
* Sets whether or not the window has a sticky button.
*/
void setStickyButton(bool flag);
/**
* Sets whether the window is sticky. A sticky window will not have
* its visibility set to false on a general setVisible(false) call.
* Use this to set the default before you call loadWindowState().
*/
void setSticky(bool sticky);
/**
* Returns whether the window is sticky.
*/
bool isSticky() const
{ return mSticky; }
/**
* Overloads window setVisible by Guichan to allow sticky window
* handling.
*/
virtual void setVisible(bool visible);
/**
* Overloads window setVisible by Guichan to allow sticky window
* handling, or not, if you force the sticky state.
*/
void setVisible(bool visible, bool forceSticky);
/**
* Returns whether the window is visible by default.
*/
bool isDefaultVisible() const
{ return mDefaultVisible; }
/**
* Sets whether the window is visible by default.
*/
void setDefaultVisible(bool save)
{ mDefaultVisible = save; }
/**
* Returns whether the window will save it's visibility.
*/
bool willSaveVisible() const
{ return mSaveVisible; }
/**
* Sets whether the window will save it's visibility.
*/
void setSaveVisible(bool save)
{ mSaveVisible = save; }
/**
* Returns the parent window.
*
* @return The parent window or <code>NULL</code> if there is none.
*/
Window *getParentWindow() const
{ return mParent; }
/**
* Schedule this window for deletion. It will be deleted at the start
* of the next logic update.
*/
void scheduleDelete();
/**
* Starts window resizing when appropriate.
*/
void mousePressed(gcn::MouseEvent &event);
/**
* Implements window resizing and makes sure the window is not
* dragged/resized outside of the screen.
*/
void mouseDragged(gcn::MouseEvent &event);
/**
* Implements custom cursor image changing context, based on mouse
* relative position.
*/
void mouseMoved(gcn::MouseEvent &event);
/**
* When the mouse button has been let go, this ensures that the mouse
* custom cursor is restored back to it's standard image.
*/
void mouseReleased(gcn::MouseEvent &event);
/**
* When the mouse leaves the window this ensures that the custom cursor
* is restored back to it's standard image.
*/
void mouseExited(gcn::MouseEvent &event);
/**
* Sets the name of the window. This is not the window title.
*/
void setWindowName(const std::string &name)
{ mWindowName = name; }
/**
* Returns the name of the window. This is not the window title.
*/
const std::string &getWindowName() const
{ return mWindowName; }
/**
* Reads the position (and the size for resizable windows) in the
* configuration based on the given string.
* Uses the default values when config values are missing.
* Don't forget to set these default values and resizable before
* calling this function.
*/
void loadWindowState();
/**
* Saves the window state so that when the window is reloaded, it'll
* maintain its previous state and location.
*/
void saveWindowState();
/**
* 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);
/**
* Set the default win pos and size to the current ones.
*/
void setDefaultSize();
/**
* Set the default win pos and size.
* (which can be different of the actual ones.)
* This version of setDefaultSize sets the window's position based
* on a relative enumerated position, rather than a coordinate position.
*/
void setDefaultSize(int defaultWidth, int defaultHeight,
ImageRect::ImagePosition position,
int offsetx = 0, int offsetY = 0);
/**
* Reset the win pos and size to default. Don't forget to set defaults
* first.
*/
virtual void resetToDefaultSize();
/**
* Gets the layout handler for this window.
*/
Layout &getLayout();
/**
* Clears the window's layout (useful for redesigning the window). Does
* not delete the widgets!
*/
void clearLayout();
/**
* Computes the position of the widgets according to the current
* layout. Resizes the window so that the layout fits. Deletes the
* layout.
* @param w if non-zero, force the window to this width.
* @param h if non-zero, force the window to this height.
* @note This function is meant to be called with fixed-size windows.
*/
void reflowLayout(int w = 0, int h = 0);
/**
* Adds a widget to the window and sets it at given cell.
*/
LayoutCell &place(int x, int y, gcn::Widget *, int w = 1, int h = 1);
/**
* Returns a proxy for adding widgets in an inner table of the layout.
*/
ContainerPlacer getPlacer(int x, int y);
/**
* Positions the window in the center of it's parent.
*/
void center();
/**
* Positions the window in the horisontal center of it's parent.
*/
void centerHorisontally();
/**
* Overrideable functionality for when the window is to close. This
* allows for class implementations to clean up or do certain actions
* on window close they couldn't do otherwise.
*/
virtual void close();
/**
* Allows the windows modal status to change
*/
void setModal(bool modal);
/**
* Gets the alpha value used by the window, in a GUIChan usable format.
*/
int getGuiAlpha();
gcn::Rectangle getWindowArea();
bool isResizeAllowed(gcn::MouseEvent &event);
private:
enum ResizeHandles
{
TOP = 0x01,
RIGHT = 0x02,
BOTTOM = 0x04,
LEFT = 0x08
};
/**
* Check if the window is off-screen and then move it to be visible
* again. This is internally used by loadWindowState
* and setVisible(true) members.
*/
void checkIfIsOffScreen(bool partially = true, bool entirely = true);
/**
* Determines if the mouse is in a resize area and returns appropriate
* resize handles. Also initializes drag offset in case the resize
* grip is used.
*
* @see ResizeHandles
*/
int getResizeHandles(gcn::MouseEvent &event);
ResizeGrip *mGrip; /**< Resize grip */
Window *mParent; /**< The parent window */
Layout *mLayout; /**< Layout handler */
std::string mWindowName; /**< Name of the window */
bool mShowTitle; /**< Window has a title bar */
bool mModal; /**< Window is modal */
bool mCloseButton; /**< Window has a close button */
bool mDefaultVisible; /**< Window's default visibility */
bool mSaveVisible; /**< Window will save visibility */
bool mStickyButton; /**< Window has a sticky button */
bool mSticky; /**< Window resists hiding*/
int mMinWinWidth; /**< Minimum window width */
int mMinWinHeight; /**< Minimum window height */
int mMaxWinWidth; /**< Maximum window width */
int mMaxWinHeight; /**< Maximum window height */
int mDefaultX; /**< Default window X position */
int mDefaultY; /**< Default window Y position */
int mDefaultWidth; /**< Default window width */
int mDefaultHeight; /**< Default window height */
static int mouseResize; /**< Active resize handles */
static int instances; /**< Number of Window instances */
Skin *mSkin; /**< Skin in use by this window */
/**
* The width of the resize border. Is independent of the actual window
* border width, and determines mostly the size of the corner area
* where two borders are moved at the same time.
*/
static const unsigned resizeBorderWidth = 10;
GraphicsVertexes *mVertexes;
bool mRedraw;
};
#endif
