view ext/guichan-0.8.2/examples/action.hpp @ 697:ecaa4d98f05f tip

Abstracted the GUI code and refactored the GUIChan-specific code into its own module. * Most of the GUIChan code has been refactored into its own gui/guichan module. However, references to the GuiFont class still persist in the Engine and GuiManager code and these will need further refactoring. * GuiManager is now an abstract base class which specific implementations (e.g. GUIChan) should subclass. * The GUIChan GUI code is now a concrete implementation of GuiManager, most of which is in the new GuiChanGuiManager class. * The GUI code in the Console class has been refactored out of the Console and into the GUIChan module as its own GuiChanConsoleWidget class. The rest of the Console class related to executing commands was left largely unchanged. * Existing client code may need to downcast the GuiManager pointer received from FIFE::Engine::getGuiManager() to GuiChanGuiManager, since not all functionality is represented in the GuiManager abstract base class. Python client code can use the new GuiChanGuiManager.castTo static method for this purpose.
author M. George Hansen <technopolitica@gmail.com>
date Sat, 18 Jun 2011 00:28:40 -1000
parents 64738befdf3b
children
line wrap: on
line source

/**
 * Code to populate a global Gui object with an example of how to
 * use actions in Guichan.
 */

#include <guichan.hpp>
#include <iostream>
#include <sstream>

namespace action
{
    gcn::Container* top;
    gcn::ImageFont* font;
    gcn::Button* button1; 
    gcn::Button* button2;
    gcn::Label* label1;
    gcn::Label* label2;

    int clickCountButton1 = 0; // Holds clicks for button1
    int clickCountButton2 = 0; // Holds clicks for button2

    /*
     * To be able to recieve actions we must have a class inheriting from
     * ActionListener and implementing the action function.
     * When an action is generated in a Widget (i.e when a button is clicked)
     * that widget calls the action function for all its action listeners.
     * Below we make a class to be able to recieve our buttons actions.
     */
    class ButtonActionListener : public gcn::ActionListener
    {
    public:
        // Implement the action function in ActionListener to recieve actions
        // The eventId tells us which widget called the action function.
        void action(const gcn::ActionEvent& actionEvent)
        {
            std::string str;
            std::ostringstream os(str);

            // Here we use the widget pointer to check which widget the action
            // originated from.
            if (actionEvent.getSource() == button1)
            {
                clickCountButton1++;
                os << "Button1 clicks " << clickCountButton1;
                // Change the caption to show number of clicks
                label1->setCaption(os.str());
                // Adjust the label to fit the new caption
                label1->adjustSize();
            }
            // Here we use the event id in order to check what action occured.
            else if (actionEvent.getId() == "button2")
            {
                clickCountButton2++;
                os << "Button2 clicks " << clickCountButton2;
                // Change the caption to show number of clicks
                label2->setCaption(os.str());
                // Adjust the label to fit the new caption
                label2->adjustSize();
            }
        }
    };

    ButtonActionListener* buttonActionListener; // A pointer to the above class

    /**
     * Initialises the widgets example by populating the global Gui
     * object.
     */
    void init()
    {
         // We first create a container to be used as the top widget.
        // The top widget in Guichan can be any kind of widget, but
        // in order to make the Gui contain more than one widget we
        // make the top widget a container.
        top = new gcn::Container();
         // We set the dimension of the top container to match the screen.
        top->setDimension(gcn::Rectangle(0, 0, 640, 480));
        // Finally we pass the top widget to the Gui object.
        globals::gui->setTop(top);

        // Now we load the font used in this example.
        font = new gcn::ImageFont("fixedfont.bmp", " abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
        // Widgets may have a global font so we don't need to pass the
        // font object to every created widget. The global font is static.
        gcn::Widget::setGlobalFont(font);

        // Now we create the buttons.
        button1 = new gcn::Button("Button 1");
        button2 = new gcn::Button("Button 2");
        button1->setPosition(120, 230);
        button2->setPosition(420, 230);
        // We add the buttons to the top container.
        top->add(button1);
        top->add(button2);

        // Now we create the labels.
        label1 = new gcn::Label("Button1 clicks 0");
        label2 = new gcn::Label("Button2 clicks 0");
        label1->setPosition(100, 200);
        label2->setPosition(400, 200);
        // We add the labels to the top container.
        top->add(label1);
        top->add(label2);

        // Now we set the button's action event ids.
        button1->setActionEventId("button1");
        button2->setActionEventId("button2");

        // We make an instance of the ButtonActionListener.
        buttonActionListener = new ButtonActionListener();

        // And add the ButtonActionListener as an action listener of the buttons.
        button1->addActionListener(buttonActionListener);
        button2->addActionListener(buttonActionListener);
    }

    /**
     * Halts the action example.
     */
    void halt()
    {
        delete buttonActionListener;
        delete label1;
        delete label2;
        delete button1;
        delete button2;
        delete font;
        delete top;
    }
}