lyx_mirror/src/frontends/Alert.h

// -*- C++ -*-
/**
 * \file Alert.h
 * This file is part of LyX, the document processor.
 * Licence details can be found in the file COPYING.
 *
 * \author John Levon
 *
 * Full author contact details are available in file CREDITS
 */

#ifndef LYX_ALERT_H
#define LYX_ALERT_H

#include "support/lstrings.h"

#include <algorithm>

namespace Alert {

/**
 * Prompt for a question. Returns 0-2 for the chosen button.
 * Set default_button to a reasonable value. b1-b3 should have
 * accelerators marked with an '&'. title should be a short summary.
 * Strings should be gettextised. Please think about the poor user.
 *
 * Remember to use boost::format. If you make any of these buttons
 * "Yes" or "No", I will personally come around to your house and
 * slap you with fish, and not in an enjoyable way either.
 */
int prompt(string const & title, string const & question,
           int default_button,
	   string const & b1, string const & b2, string const & b3 = string());

/// show an alert message
void alert(string const & title, string const & s1 = string(),
	   string const & s2 = string());

/// show an alert message and strerror(errno)
void err_alert(string const & s1, string const & s2 = string());

/// Asks for a text
std::pair<bool, string> const
askForText(string const & msg,
	   string const & dflt = string());

}

#endif // LYX_ALERT_H