lyx_mirror/src/frontends/qt4/QLyXKeySym.h

// -*- C++ -*-
/**
 * \file QLyXKeySym.h
 * This file is part of LyX, the document processor.
 * Licence details can be found in the file COPYING.
 *
 * \author Asger and J<EFBFBD>rgen
 * \author John Levon
 *
 * Full author contact details are available in file CREDITS.
 */

#ifndef QLYXKEYSYM_H
#define QLYXKEYSYM_H

#include "frontends/LyXKeySym.h"

#include <QString>
#include <QKeyEvent>


class QKeyEvent;

namespace lyx {

/**
 * Qt-specific key press.
 *
 * This is some really sick stuff.
 */
class QLyXKeySym : public LyXKeySym {
public:
	QLyXKeySym();

	virtual ~QLyXKeySym() {}

	/// .
	/// inlined out because of profiling results under linux when
	/// opening a document.
	inline bool operator==(LyXKeySym const& ks) const;

	/// delayed constructor
	void set(QKeyEvent * ev);

	/// set from a LyX symbolic name
	virtual void init(std::string const & symbolname);

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

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

	/// return the LyX symbolic name
	virtual std::string getSymbolName() const;

	/// Is this normal insertable text ? (last ditch attempt only)
	virtual bool isText() const;

	/**
	 * Return the value of the keysym into the UCS-4 encoding.
	 * This converts the LyXKeySym to a 32-bit encoded character.
	 */
	virtual size_t getUCSEncoded() const;

	/**
	 * Return a human-readable version of a key+modifier pair.
	 * This will be the GUI version (translated and with special
	 * characters for Mac OS X) when \c forgui is true.
	 */
	virtual docstring const print(key_modifier::state mod, bool forgui) const;

	///
	int key() const {
		return key_;
	}
private:
	/// the Qt sym value
	int key_;
	/// the event string value
	QString text_;
};


} // namespace lyx

#endif // QLYXKEYSYM_H