quit_confirmation.hpp

Go to the documentation of this file.

/*
   Copyright (C) 2015 - 2016 by 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 QUIT_CONFIRMATION_HPP_INCLUDED
#define QUIT_CONFIRMATION_HPP_INCLUDED

class CVideo;

#include <cassert>
#include <vector>

#include "utils/functional.hpp"

/**
 * Implements a quit confirmation dialog.
 *
 * Any object of this type will prevent the game from quitting immediately.
 * Instead, a confirmation dialog will pop up when attempting to close.
 */
class quit_confirmation
{
public:
    explicit quit_confirmation(const std::function<bool()>& prompt = &quit_confirmation::default_prompt)
        : prompt_(prompt) { blockers_.push_back(this); }

    ~quit_confirmation() { blockers_.pop_back(); }

    /**
     * Shows the quit confirmation if needed.
     *
     * @throws CVideo::quit If the user chooses to quit or no prompt was
     *                      displayed.
     */
    static bool quit();
    static void quit_to_title();
    static void quit_to_desktop();

    static bool show_prompt(const std::string& message);
    static bool default_prompt();

private:
    //noncopyable
    quit_confirmation( const quit_confirmation& );
    const quit_confirmation& operator=( const quit_confirmation& );
    static std::vector<quit_confirmation*> blockers_;
    static bool open_;

    std::function<bool()> prompt_;
};

#endif