lyx_mirror/src/frontends/LyXKeySym.h

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

#ifndef LYXKEYSYM_H
#define LYXKEYSYM_H

#include "LString.h"
#include <boost/shared_ptr.hpp>

/**
 * This is a base class for representing a keypress.
 * Each frontend has to implement this to provide
 * the functionality that LyX needs in regards to
 * key presses.
 */
class LyXKeySym {
public:
	LyXKeySym() {}

	virtual ~LyXKeySym() {}

	/// Initialize with the name of a key. F. ex. "space" or "a"
	virtual void init(string const & symbolname) = 0;

	/// Is this a valid key?
	virtual bool isOK() const = 0;

	/// Is this a modifier key only?
	virtual bool isModifier() const = 0;

	/// Is this normal insertable text ? (last ditch attempt only)
	virtual bool isText() const { return false; }
 
	/// What is the symbolic name of this key? F.ex. "Return" or "c"
	virtual string getSymbolName() const = 0;

	/**
	 * Return the value of the keysym into the local ISO encoding.
	 * This converts the LyXKeySym to a 8-bit encoded character.
	 * This relies on user to use the right encoding.
	 */
	virtual char getISOEncoded(string const & encoding) const = 0;
};


/**
 * We need to be able to equality compare these for the
 * sake of the keymap business.
 */
bool operator==(LyXKeySym const & k1, LyXKeySym const & k2);

typedef boost::shared_ptr<LyXKeySym> LyXKeySymPtr;

#endif