dbRelMaintainer Class Reference
[OOFILE Database package]

#include <oof1.h>

Inheritance diagram for dbRelMaintainer:

[legend]Collaboration diagram for dbRelMaintainer:

[legend]List of all members.

---

Detailed Description

listener for an MN link that adds and deletes records.

Acts in response to OOF_AppendSelection, RemoveSelection, ClearSelection and is often used in GUI applications where the user can create M:N links between tables, eg: by drag and drop to indicate an association.

Public Member Functions
	dbRelMaintainer (dbRelRefBase *relToRHS, OOF_RelMN *linkWeAlert)
virtual	~dbRelMaintainer ()
virtual bool	receiveMsg (OOFmsgT msg, unsigned long senderDefined)
	The default receiveMsg behaviour is to delete yourself when the broadcaster closes.
virtual void	subscribeTo (oofBroadcaster *)
virtual void	unsubscribe (oofBroadcaster *from=0)
void	suspendListening ()
void	resumeListening ()
Protected Attributes
oofBroadcaster *	mListensTo
oofBroadcaster *	mSuspendedListensTo
unsigned short	mSuspendCount

---

Constructor & Destructor Documentation

dbRelMaintainer::dbRelMaintainer (  dbRelRefBase *  relToRHS, OOF_RelMN *  linkWeAlert )

dbRelMaintainer::~dbRelMaintainer (   )  [virtual]

---

Member Function Documentation

bool dbRelMaintainer::receiveMsg (  OOFmsgT  msg, unsigned long  senderDefined )  [virtual]

The default receiveMsg behaviour is to delete yourself when the broadcaster closes. In many user subclasses oofSingleListener is a mixin and you have a class owned elsewhere, not self-deleting. Warning: If a subclass is not self-deleting it MUST override receiveMsg handling of the msg OOFmsg_BroadcasterClosing to prevent runtime error. However it is still important to set mListensTo=0 otherwise when you finally get around to deleting your oofSingleListener, it will try to update a deleted oofBroadcaster and cause a crash. Reimplemented from oofSingleListener.

void oofSingleListener::resumeListening (   )  [inherited]

void oofSingleListener::subscribeTo (  oofBroadcaster *   )  [virtual, inherited]

Reimplemented from oofReceiver.

void oofSingleListener::suspendListening (   )  [inherited]

void oofSingleListener::unsubscribe (  oofBroadcaster *  from = 0  )  [virtual, inherited]

Reimplemented from oofReceiver.

---

Member Data Documentation

oofBroadcaster* oofSingleListener::mListensTo [protected, inherited]

unsigned short oofSingleListener::mSuspendCount [protected, inherited]

oofBroadcaster* oofSingleListener::mSuspendedListensTo [protected, inherited]

---

The documentation for this class was generated from the following files:

• oof1.h
• oofrel.cpp

---