1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164
|
/****************************************************************************
** $Id: qsignalmapper.cpp,v 1.15 1999/05/05 03:06:44 warwick Exp $
**
** Implementation of QSignalMapper class
**
** Created : 980503
**
** Copyright (C) 1992-1999 Troll Tech AS. All rights reserved.
**
** This file is part of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Troll Tech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** Licensees holding valid Qt Professional Edition licenses may use this
** file in accordance with the Qt Professional Edition License Agreement
** provided with the Qt Professional Edition.
**
** See http://www.troll.no/pricing.html or email sales@troll.no for
** information about the Professional Edition licensing, or see
** http://www.troll.no/qpl/ for QPL licensing information.
**
*****************************************************************************/
#include "qsignalmapper.h"
#include "qptrdict.h"
struct QSignalMapperRec {
QSignalMapperRec()
{
has_int = 0;
str_id = QString::null;
}
uint has_int:1;
int int_id;
QString str_id;
// extendable to other types of identification
};
class QSignalMapperData {
public:
QSignalMapperData()
{
dict.setAutoDelete( TRUE );
}
QPtrDict<QSignalMapperRec> dict;
};
/*!
\class QSignalMapper qsignalmapper.h
\brief A QSignalMapper object bundles signals from identifiable senders.
Collects a set of parameterless signals, re-emitting them with an
integer or string parameters corresponding to the object which sent the
signal.
*/
/*!
Constructs a QSignalMapper. Like all QObjects, it will be deleted when the
parent is deleted.
*/
QSignalMapper::QSignalMapper( QObject* parent, const char* name ) :
QObject( parent, name )
{
d = new QSignalMapperData;
}
/*!
Destructs the QSignalMapper.
*/
QSignalMapper::~QSignalMapper()
{
delete d;
}
/*!
Adds a mapping such that when map() is signalled from the given
sender, the signal mapped(identifier) is emitted.
There may be at most one integer identifier for each object.
*/
void QSignalMapper::setMapping( const QObject* sender, int identifier )
{
QSignalMapperRec* rec = getRec(sender);
rec->int_id = identifier;
rec->has_int = 1;
}
/*!
Adds a mapping such that when map() is signalled from the given
sender, the signal mapper(identifier) is emitted.
There may be at most one string identifier for each object, and
it may not be null.
*/
void QSignalMapper::setMapping( const QObject* sender, const QString &identifier )
{
QSignalMapperRec* rec = getRec(sender);
rec->str_id = identifier;
}
/*!
Removes all mappings for \a sender. This is done automatically
when mapped objects are destroyed.
*/
void QSignalMapper::removeMappings( const QObject* sender )
{
d->dict.remove((void*)sender);
}
void QSignalMapper::removeMapping()
{
removeMappings(sender());
}
/*!
This slot emits signals based on which object sends signals
to it.
*/
void QSignalMapper::map()
{
const QObject* s = sender();
QSignalMapperRec* rec = d->dict.find( (void*)s );
if ( rec ) {
if ( rec->has_int )
emit mapped( rec->int_id );
if ( !rec->str_id.isEmpty() )
emit mapped( rec->str_id );
}
}
QSignalMapperRec* QSignalMapper::getRec( const QObject* sender )
{
QSignalMapperRec* rec = d->dict.find( (void*)sender );
if (!rec) {
rec = new QSignalMapperRec;
d->dict.insert( (void*)sender, rec );
connect( sender, SIGNAL(destroyed()), this, SLOT(removeMapping()) );
}
return rec;
}
/*!
\fn void QSignalMapper::mapped(int)
This signal is emitted when map() is signalled from an object which
has an integer mapping set.
\sa setMapping(int)
*/
/*!
\fn void QSignalMapper::mapped(const QString&)
This signal is emitted when map() is signalled from an object which
has a string mapping set.
\sa setMapping(QString)
*/
|