You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
101 lines
3.8 KiB
101 lines
3.8 KiB
15 years ago
|
/* This file is part of the KDE project
|
||
|
|
Copyright (C) 2004 Cedric Pasteur <cedric.pasteur@free.fr>
|
||
|
|
|
||
|
|
This library is free software; you can redistribute it and/or
|
||
|
|
modify it under the terms of the GNU Library General Public
|
||
|
|
License as published by the Free Software Foundation; either
|
||
|
|
version 2 of the License, or (at your option) any later version.
|
||
|
|
|
||
|
|
This library is distributed in the hope that it will be useful,
|
||
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
|
Library General Public License for more details.
|
||
|
|
|
||
|
|
You should have received a copy of the GNU Library General Public License
|
||
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
||
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
||
|
|
* Boston, MA 02110-1301, USA.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef KFORMDESIGNEREVENTS_H
|
||
|
|
#define KFORMDESIGNEREVENTS_H
|
||
|
|
|
||
|
|
#include <qvaluelist.h>
|
||
|
|
#include <qguardedptr.h>
|
||
|
|
|
||
|
|
class QDomNode;
|
||
|
|
class QObject;
|
||
|
|
|
||
|
|
//! A simple class to store events
|
||
|
|
/*! There are three different types of events (an maybe more in the future):
|
||
|
|
* signal to slot: sender and receiver are both widgets.
|
||
|
|
* signal to user function: whenever the signal is emitted, a function in the form script is called.
|
||
|
|
* signal to action: the signal activates an application action (eg addNewRecord in Kexi)
|
||
|
|
(other :* global signal to user function: an application global signal (new window opened, etc.) calls a user script function)
|
||
|
|
|
||
|
|
\todo add aliases for slot()?? (eg actionName())
|
||
|
|
*/
|
||
|
|
class KEXICORE_EXPORT Event
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
Event(QObject *sender, const QCString &signal,
|
||
|
|
QObject *receiver, const QCString &slot);
|
||
|
|
Event(QObject *sender, const QCString &signal,
|
||
|
|
const QCString &functionName);
|
||
|
|
Event() : m_type(Slot) {;}
|
||
|
|
~Event() {;}
|
||
|
|
|
||
|
|
enum { Slot=1000, UserFunction, Action }; //! Event types
|
||
|
|
int type() {return m_type; }
|
||
|
|
void setType(int type) { m_type = type; }
|
||
|
|
|
||
|
|
QObject* sender() const { return m_sender; }
|
||
|
|
QObject* receiver() const { return m_receiver; }
|
||
|
|
QCString signal() const { return m_signal; }
|
||
|
|
QCString slot() const { return m_slot; }
|
||
|
|
|
||
|
|
void setSender(QObject *o) { m_sender = o; }
|
||
|
|
void setReceiver(QObject *o) { m_receiver = o; }
|
||
|
|
void setSignal(const QCString &s) { m_signal = s; }
|
||
|
|
void setSlot(const QCString &s) { m_slot = s; }
|
||
|
|
|
||
|
|
protected:
|
||
|
|
QGuardedPtr<QObject> m_sender;
|
||
|
|
QCString m_signal;
|
||
|
|
QGuardedPtr<QObject> m_receiver;
|
||
|
|
QCString m_slot;
|
||
|
|
int m_type;
|
||
|
|
};
|
||
|
|
|
||
|
|
class KEXICORE_EXPORT EventList : protected QValueList<Event*>
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
EventList() {;}
|
||
|
|
~EventList() {;}
|
||
|
|
|
||
|
|
/*! Adds an event in list. Other overload are available, so that
|
||
|
|
other classes don't have to use Event class in simple cases. */
|
||
|
|
void addEvent(Event *event);
|
||
|
|
void addEvent(QObject *sender, const QCString &signal, QObject *receiver, const QCString &slot);
|
||
|
|
void addEvent(QObject *sender, const QCString &signal, const QCString &action);
|
||
|
|
/*! Removes the Event \a event from the FormScript's list. */
|
||
|
|
void removeEvent(Event *event);
|
||
|
|
|
||
|
|
/*! \return A list of events related to widget \a name (ie where Event::sender()
|
||
|
|
or Event::receiver() == name). */
|
||
|
|
EventList* allEventsForObject(QObject *object);
|
||
|
|
/*! Replace all ocurrences of \a oldname with \a newName inside the list. */
|
||
|
|
//void renameWidget(const QCString &oldName, const QCString &newName);
|
||
|
|
/*! Removes all events related to widget \a name. Called eg when widget is destroyed. */
|
||
|
|
void removeAllEventsForObject(QObject *object);
|
||
|
|
|
||
|
|
// make some QValueList function accessible by other classes
|
||
|
|
QValueListConstIterator<Event*> constBegin() const { return QValueList<Event*>::constBegin(); }
|
||
|
|
QValueListConstIterator<Event*> constEnd() const { return QValueList<Event*>::constEnd(); }
|
||
|
|
bool isEmpty() const { return QValueList<Event*>::isEmpty(); }
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|