/* * The ManaPlus Client * Copyright (C) 2008-2009 The Mana World Development Team * Copyright (C) 2009-2010 The Mana Developers * Copyright (C) 2011-2014 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 GUI_WIDGETS_GUITABLE_H #define GUI_WIDGETS_GUITABLE_H #include "localconsts.h" #include "gui/widgets/tablemodel.h" #include "gui/widgets/widget2.h" #include "gui/base/keylistener.hpp" #include "gui/base/mouselistener.hpp" #include "gui/base/widget.hpp" #include <vector> class GuiTableActionListener; /** * A table, with rows and columns made out of sub-widgets. Largely inspired by * (and can be thought of as a generalisation of) the guichan listbox * implementation. * * Normally you want this within a ScrollArea. * * \ingroup GUI */ class GuiTable final : public gcn::Widget, public Widget2, public gcn::MouseListener, public gcn::KeyListener, public TableModelListener { // so that the action listener can call distributeActionEvent friend class GuiTableActionListener; public: GuiTable(const Widget2 *const widget, TableModel *const initial_model, const bool opacity = true); A_DELETE_COPY(GuiTable) ~GuiTable(); /** * Retrieves the active table model */ const TableModel *getModel() const A_WARN_UNUSED; /** * Sets the table model * * Note that actions issued by widgets returned from the model will update * the table selection, but only AFTER any event handlers installed within * the widget have been triggered. To be notified after such an update, add * an action listener to the table instead. */ void setModel(TableModel *const m); void setSelected(const int row, const int column); int getSelectedRow() const A_WARN_UNUSED; int getSelectedColumn() const A_WARN_UNUSED; void setSelectedRow(const int selected); void setSelectedColumn(const int selected); bool isWrappingEnabled() const A_WARN_UNUSED { return mWrappingEnabled; } void setWrappingEnabled(bool wrappingEnabled) { mWrappingEnabled = wrappingEnabled; } gcn::Rectangle getChildrenArea() override final A_WARN_UNUSED; /** * Toggle whether to use linewise selection mode, in which the table selects * an entire line at a time, rather than a single cell. * * Note that column information is tracked even in linewise selection mode; * this mode therefore only affects visualisation. * * Disabled by default. * * \param linewise: Whether to enable linewise selection mode */ void setLinewiseSelection(bool linewise) { mLinewiseMode = linewise; } // Inherited from Widget void draw(Graphics* graphics) override final; gcn::Widget *getWidgetAt(int x, int y) override final A_WARN_UNUSED; void moveToTop(gcn::Widget *child) override final; void moveToBottom(gcn::Widget *child) override final; void _setFocusHandler(gcn::FocusHandler* focusHandler) override final; // Inherited from KeyListener void keyPressed(gcn::KeyEvent& keyEvent) override final; /** * Sets the table to be opaque, that is sets the table * to display its background. * * @param opaque True if the table should be opaque, false otherwise. */ void setOpaque(bool opaque) { mOpaque = opaque; } /** * Checks if the table is opaque, that is if the table area displays its * background. * * @return True if the table is opaque, false otherwise. */ bool isOpaque() const A_WARN_UNUSED { return mOpaque; } // Inherited from MouseListener void mousePressed(gcn::MouseEvent& mouseEvent) override final; void mouseWheelMovedUp(gcn::MouseEvent& mouseEvent) override final; void mouseWheelMovedDown(gcn::MouseEvent& mouseEvent) override final; void mouseDragged(gcn::MouseEvent& mouseEvent) override final; // Constraints inherited from TableModelListener void modelUpdated(const bool completed) override final; void requestFocus(); void setSelectable(bool b) { mSelectable = b; } protected: /** Frees all action listeners on inner widgets. */ void uninstallActionListeners(); /** Installs all action listeners on inner widgets. */ void installActionListeners(); int getRowHeight() const A_WARN_UNUSED; int getColumnWidth(const int i) const A_WARN_UNUSED; private: int getRowForY(int y) const A_WARN_UNUSED; // -1 on error int getColumnForX(int x) const A_WARN_UNUSED; // -1 on error void recomputeDimensions(); static float mAlpha; TableModel *mModel; /** If someone moves a fresh widget to the top, we must display it. */ gcn::Widget *mTopWidget; /** Vector for compactness; used as a list in practice. */ std::vector<GuiTableActionListener *> mActionListeners; /** * Holds the background color of the table. */ gcn::Color mHighlightColor; int mSelectedRow; int mSelectedColumn; bool mLinewiseMode; bool mWrappingEnabled; bool mOpaque; bool mSelectable; }; #endif // GUI_WIDGETS_GUITABLE_H