gui/dialogs/network_transmission.hpp

Go to the documentation of this file.

/* $Id: network_transmission.hpp 54116 2012-05-07 00:15:14Z loonycyborg $ */
/*
   Copyright (C) 2011 - 2012 by Sergey Popov <loonycyborg@gmail.com>
   Part of the Battle for Wesnoth Project http://www.wesnoth.org/

   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
   (at your option) any later version.
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY.

   See the COPYING file for more details.
*/

#ifndef GUI_DIALOGS_NETWORK_RECEIVE_HPP_INCLUDED
#define GUI_DIALOGS_NETWORK_RECEIVE_HPP_INCLUDED

#include "gui/dialogs/dialog.hpp"
#include "gui/widgets/control.hpp"
#include "network_asio.hpp"
#include <boost/optional.hpp>

namespace gui2 {

class tnetwork_transmission;

/**
 * Dialog that tracks network transmissions
 *
 * It shows upload/download progress and allows the user
 * to cancel the transmission.
 */
class tnetwork_transmission : public tdialog
{
    network_asio::connection& connection_;

    class pump_monitor : public events::pump_monitor
    {
        network_asio::connection& connection_;
        bool& track_upload_;
        virtual void process(events::pump_info&);
        public:
        pump_monitor(network_asio::connection& connection, bool& track_upload)
            : connection_(connection)
            , track_upload_(track_upload)
            , window_()
        {
        }

        boost::optional<twindow&> window_;
    } pump_monitor;
public:

    tnetwork_transmission(
          network_asio::connection& connection
        , const std::string& title
        , const std::string& subtitle);

    void set_subtitle(const std::string&);
    void set_track_upload(bool track_upload) { track_upload_ = track_upload; }

protected:
    /** Inherited from tdialog. */
    void pre_show(CVideo& video, twindow& window);

    /** Inherited from tdialog. */
    void post_show(twindow& window);

private:
    bool track_upload_;
    /**
     * The subtitle for the dialog.
     *
     * This field commenly shows the action in progress eg connecting,
     * uploading, downloading etc..
     */
    std::string subtitle_;

    /** Inherited from tdialog, implemented by REGISTER_DIALOG. */
    virtual const std::string& window_id() const;
};

} // namespace gui2

#endif