lyx_mirror/src/FuncRequest.h
Jean-Marc Lasgouttes 0ef36860c3 Handle sending a FuncRequest object to lyxerr
* Implement the corresponding operator<<

  * Use it in a couple new places
2012-06-07 17:21:49 +02:00

119 lines
2.9 KiB
C++

// -*- C++ -*-
/**
* \file FuncRequest.h
* This file is part of LyX, the document processor.
* Licence details can be found in the file COPYING.
*
* \author André Pönitz
*
* Full author contact details are available in file CREDITS.
*/
#ifndef FUNCREQUEST_H
#define FUNCREQUEST_H
#include "FuncCode.h"
#include "support/docstring.h"
#include "frontends/mouse_state.h"
namespace lyx {
class LyXErr;
/**
* This class encapsulates a LyX action and its argument
* in order to pass it around easily.
*/
class FuncRequest
{
public:
/// Where the request came from
enum Origin {
INTERNAL,
MENU, // A menu entry
TOOLBAR, // A toolbar icon
KEYBOARD, // a keyboard binding
COMMANDBUFFER,
LYXSERVER,
TOC
};
/// just for putting these things in std::container
explicit FuncRequest(Origin o = INTERNAL);
/// actions without extra argument
explicit FuncRequest(FuncCode act, Origin o = INTERNAL);
/// actions without extra argument
FuncRequest(FuncCode act, int x, int y, mouse_button::state button,
Origin o = INTERNAL);
/// actions with extra argument
FuncRequest(FuncCode act, docstring const & arg,
Origin o = INTERNAL);
/// actions with extra argument. FIXME: remove this
FuncRequest(FuncCode act, std::string const & arg,
Origin o = INTERNAL);
/// for changing requests a bit
FuncRequest(FuncRequest const & cmd, docstring const & arg,
Origin o = INTERNAL);
/// for changing requests a bit. FIXME: remove this
FuncRequest(FuncRequest const & cmd, std::string const & arg,
Origin o = INTERNAL);
/// access the whole argument
docstring const & argument() const { return argument_; }
///
FuncCode action() const { return action_ ; }
///
void setAction(FuncCode act) { action_ = act; }
///
Origin origin() const { return origin_; }
///
void setOrigin(Origin o) { origin_ = o; }
///
int x() const { return x_; }
///
int y() const { return y_; }
///
void set_y(int y) { y_ = y; }
///
mouse_button::state button() const { return button_; }
/// argument parsing, extract argument i as std::string
std::string getArg(unsigned int i) const;
/// argument parsing, extract argument i as std::string,
/// eating all characters up to the end of the command line
std::string getLongArg(unsigned int i) const;
///
static FuncRequest const unknown;
///
static FuncRequest const noaction;
private:
/// the action
FuncCode action_;
/// the action's string argument
docstring argument_;
/// who initiated the action
Origin origin_;
/// the x coordinate of a mouse press
int x_;
/// the y coordinate of a mouse press
int y_;
/// some extra information (like button number)
mouse_button::state button_;
};
bool operator==(FuncRequest const & lhs, FuncRequest const & rhs);
std::ostream & operator<<(std::ostream &, FuncRequest const &);
LyXErr & operator<<(LyXErr &, FuncRequest const &);
} // namespace lyx
#endif // FUNCREQUEST_H