class TMessageHandler: public TNamed, public TQObject


TMessageHandler

Handle messages that might be generated by the system.
By default a handler only keeps track of the different messages
generated for a specific class. By deriving from this class and
overriding Notify() one can implement custom message handling.
In Notify() one has access to the message id and the object
generating the message. One can install more than one message
handler per class. A message handler can be removed or again
added when needed.
All Root "Warnings"  are logged as message 1001
All Root "Errors"    are logged as message 1002
All Root "SysErrors" are logged as message 1003
All Root "Fatals"    are logged as message 1004

Function Members (Methods)

public:

	TMessageHandler(const TClass* cl, Bool_t derived = kTRUE)
	TMessageHandler(const char* cl, Bool_t derived = kTRUE)
virtual	~TMessageHandler()
void	TObject::AbstractMethod(const char* method) const
virtual void	Add()
virtual void	Added()SIGNAL
virtual void	TObject::AppendPad(Option_t* option = "")
static Bool_t	TQObject::AreAllSignalsBlocked()
Bool_t	TQObject::AreSignalsBlocked() const
static Bool_t	TQObject::BlockAllSignals(Bool_t b)
Bool_t	TQObject::BlockSignals(Bool_t b)
virtual void	TObject::Browse(TBrowser* b)
virtual void	TQObject::ChangedBy(const char* method)SIGNAL
static TClass*	Class()
virtual const char*	TObject::ClassName() const
virtual void	TNamed::Clear(Option_t* option = "")
virtual TObject*	TNamed::Clone(const char* newname = "") const
void	TQObject::CollectClassSignalLists(TList& list, TClass* cls)
virtual Int_t	TNamed::Compare(const TObject* obj) const
Bool_t	TQObject::Connect(const char* signal, const char* receiver_class, void* receiver, const char* slot)
static Bool_t	TQObject::Connect(TQObject* sender, const char* signal, const char* receiver_class, void* receiver, const char* slot)
static Bool_t	TQObject::Connect(const char* sender_class, const char* signal, const char* receiver_class, void* receiver, const char* slot)
virtual void	TQObject::Connected(const char*)
virtual void	TNamed::Copy(TObject& named) const
virtual void	TObject::Delete(Option_t* option = "")MENU
virtual void	TQObject::Destroyed()SIGNAL
Bool_t	TQObject::Disconnect(const char* signal = 0, void* receiver = 0, const char* slot = 0)
static Bool_t	TQObject::Disconnect(TQObject* sender, const char* signal = 0, void* receiver = 0, const char* slot = 0)
static Bool_t	TQObject::Disconnect(const char* class_name, const char* signal, void* receiver = 0, const char* slot = 0)
virtual void	TQObject::Disconnected(const char*)
virtual Int_t	TObject::DistancetoPrimitive(Int_t px, Int_t py)
virtual void	TObject::Draw(Option_t* option = "")
virtual void	TObject::DrawClass() constMENU
virtual TObject*	TObject::DrawClone(Option_t* option = "") constMENU
virtual void	TObject::Dump() constMENU
void	TQObject::Emit(const char* signal)
void	TQObject::Emit(const char* signal, Long_t* paramArr)
void	TQObject::Emit(const char* signal, const char* params)
void	TQObject::Emit(const char* signal, Double_t param)
void	TQObject::Emit(const char* signal, Long_t param)
void	TQObject::Emit(const char* signal, Long64_t param)
void	TQObject::Emit(const char* signal, Bool_t param)
void	TQObject::Emit(const char* signal, Char_t param)
void	TQObject::Emit(const char* signal, UChar_t param)
void	TQObject::Emit(const char* signal, Short_t param)
void	TQObject::Emit(const char* signal, UShort_t param)
void	TQObject::Emit(const char* signal, Int_t param)
void	TQObject::Emit(const char* signal, UInt_t param)
void	TQObject::Emit(const char* signal, ULong_t param)
void	TQObject::Emit(const char* signal, ULong64_t param)
void	TQObject::Emit(const char* signal, Float_t param)
void	TQObject::EmitVA(const char* signal, Int_t nargs)
void	TQObject::EmitVA(const char* signal, Int_t nargs, va_list va)
virtual void	TObject::Error(const char* method, const char* msgfmt) const
virtual void	TObject::Execute(const char* method, const char* params, Int_t* error = 0)
virtual void	TObject::Execute(TMethod* method, TObjArray* params, Int_t* error = 0)
virtual void	TObject::ExecuteEvent(Int_t event, Int_t px, Int_t py)
virtual void	TObject::Fatal(const char* method, const char* msgfmt) const
virtual void	TNamed::FillBuffer(char*& buffer)
virtual TObject*	TObject::FindObject(const char* name) const
virtual TObject*	TObject::FindObject(const TObject* obj) const
virtual Option_t*	TObject::GetDrawOption() const
static Long_t	TObject::GetDtorOnly()
virtual const char*	TObject::GetIconName() const
TList*	TQObject::GetListOfClassSignals() const
TList*	TQObject::GetListOfConnections() const
TList*	TQObject::GetListOfSignals() const
virtual Int_t	GetMessageCount(Int_t messId) const
virtual const char*	TNamed::GetName() const
virtual char*	TObject::GetObjectInfo(Int_t px, Int_t py) const
static Bool_t	TObject::GetObjectStat()
virtual Option_t*	TObject::GetOption() const
Int_t	GetSize() const
virtual const char*	TNamed::GetTitle() const
virtual Int_t	GetTotalMessageCount() const
virtual UInt_t	TObject::GetUniqueID() const
Bool_t	HandleDerived() const
virtual void	HandleMessage(Int_t id, const TObject* obj)
virtual Bool_t	TObject::HandleTimer(TTimer* timer)
virtual Bool_t	TQObject::HasConnection(const char* signal_name) const
virtual ULong_t	TNamed::Hash() const
virtual void	TQObject::HighPriority(const char* signal_name, const char* slot_name = 0)
virtual void	TObject::Info(const char* method, const char* msgfmt) const
virtual Bool_t	TObject::InheritsFrom(const char* classname) const
virtual Bool_t	TObject::InheritsFrom(const TClass* cl) const
virtual void	TObject::Inspect() constMENU
void	TObject::InvertBit(UInt_t f)
virtual TClass*	IsA() const
virtual Bool_t	TObject::IsEqual(const TObject* obj) const
virtual Bool_t	TObject::IsFolder() const
Bool_t	TObject::IsOnHeap() const
virtual Bool_t	TNamed::IsSortable() const
Bool_t	TObject::IsZombie() const
static void	TQObject::LoadRQ_OBJECT()
virtual void	TQObject::LowPriority(const char* signal_name, const char* slot_name = 0)
virtual void	TNamed::ls(Option_t* option = "") const
void	TObject::MayNotUse(const char* method) const
virtual void	TQObject::Message(const char* msg)SIGNAL
virtual void	Notified()SIGNAL
virtual Bool_t	Notify()
virtual Int_t	TQObject::NumberOfConnections() const
virtual Int_t	TQObject::NumberOfSignals() const
void	TObject::Obsolete(const char* method, const char* asOfVers, const char* removedFromVers) const
static void	TObject::operator delete(void* ptr)
static void	TObject::operator delete(void* ptr, void* vp)
static void	TObject::operator delete[](void* ptr)
static void	TObject::operator delete[](void* ptr, void* vp)
void*	TObject::operator new(size_t sz)
void*	TObject::operator new(size_t sz, void* vp)
void*	TObject::operator new[](size_t sz)
void*	TObject::operator new[](size_t sz, void* vp)
TNamed&	TNamed::operator=(const TNamed& rhs)
virtual void	TObject::Paint(Option_t* option = "")
virtual void	TObject::Pop()
virtual void	Print(Option_t* option = "") const
virtual Int_t	TObject::Read(const char* name)
virtual void	TObject::RecursiveRemove(TObject* obj)
virtual void	Remove()
virtual void	Removed()SIGNAL
void	TObject::ResetBit(UInt_t f)
virtual void	TObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU
virtual void	TObject::SavePrimitive(ostream& out, Option_t* option = "")
void	TObject::SetBit(UInt_t f)
void	TObject::SetBit(UInt_t f, Bool_t set)
virtual void	TObject::SetDrawOption(Option_t* option = "")MENU
static void	TObject::SetDtorOnly(void* obj)
virtual void	TNamed::SetName(const char* name)MENU
virtual void	TNamed::SetNameTitle(const char* name, const char* title)
static void	TObject::SetObjectStat(Bool_t stat)
virtual void	TNamed::SetTitle(const char* title = "")MENU
virtual void	TObject::SetUniqueID(UInt_t uid)
virtual void	ShowMembers(TMemberInspector& insp)
virtual Int_t	TNamed::Sizeof() const
virtual void	Streamer(TBuffer& b)
void	StreamerNVirtual(TBuffer& b)
virtual void	TObject::SysError(const char* method, const char* msgfmt) const
Bool_t	TObject::TestBit(UInt_t f) const
Int_t	TObject::TestBits(UInt_t f) const
virtual void	TObject::UseCurrentStyle()
virtual void	TObject::Warning(const char* method, const char* msgfmt) const
virtual Int_t	TObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)
virtual Int_t	TObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0) const

protected:

static Int_t	TQObject::CheckConnectArgs(TQObject* sender, TClass* sender_class, const char* signal, TClass* receiver_class, const char* slot)
static Bool_t	TQObject::ConnectToClass(TQObject* sender, const char* signal, TClass* receiver_class, void* receiver, const char* slot)
static Bool_t	TQObject::ConnectToClass(const char* sender_class, const char* signal, TClass* receiver_class, void* receiver, const char* slot)
virtual void	TObject::DoError(int level, const char* location, const char* fmt, va_list va) const
virtual void*	GetSender()
virtual const char*	TQObject::GetSenderClassName() const
void	TObject::MakeZombie()

Data Members

public:

enum TObject::EStatusBits {	kCanDelete
	kMustCleanup
	kObjInCanvas
	kIsReferenced
	kHasUUID
	kCannotPick
	kNoContextMenu
	kInvalidObject
};
enum TObject::[unnamed] {	kIsOnHeap
	kNotDeleted
	kZombie
	kBitMask
	kSingleKey
	kOverwrite
	kWriteDelete
};

protected:

const TClass*	fClass	class for which message has to be handled
Int_t*	fCnts	count per message
Bool_t	fDerived	if true handle messages also for derived classes
TList*	TQObject::fListOfConnections	! list of connections to this object
TList*	TQObject::fListOfSignals	! list of signals from this object
Int_t	fMessId	message id (often matching specific enum in fClass)
Int_t*	fMessIds	message ids
const TObject*	fMessObj	object generating message
TString	TNamed::fName	object identifier
Bool_t	TQObject::fSignalsBlocked	! flag used for suppression of signals
Int_t	fSize	number of different messages handled
TString	TNamed::fTitle	object title
static Bool_t	TQObject::fgAllSignalsBlocked	flag used for suppression of all signals

Class Charts

Inheritance Inherited Members Includes Libraries

Function documentation

TMessageHandler(const TClass* cl, Bool_t derived = kTRUE)

 Create a new message handler for class cl and add it to the list
 of message handlers.

TMessageHandler(const char* cl, Bool_t derived = kTRUE)

 Create a new message handler for class named cl and add it to the list
 of message handlers.

void Add()

 Add this message handler to the list of messages handlers.

Int_t GetMessageCount(Int_t messId) const

 Return counter for message with ID=messid.

Int_t GetTotalMessageCount() const

 Return total number of messages.

void HandleMessage(Int_t id, const TObject* obj)

 Store message origin, keep statistics and call Notify().

Bool_t Notify()

 This method must be overridden to handle object notifcation.

void Print(Option_t* option = "") const

 Print statistics for this message handler.

void Remove()

 Remove this message handler from the list of messages handlers.

void * GetSender()

{ return this; }

virtual ~TMessageHandler()

Int_t GetSize() const

{ return fSize; }

Bool_t HandleDerived() const

{ return fDerived; }

void Added()

{ Emit("Added()"); }

void Removed()

{ Emit("Removed()"); }

void Notified()

{ Emit("Notified()"); }