TObject
class description - source file - inheritance tree
protected:
void MakeZombie()
public:
TObject TObject()
TObject TObject(const TObject& object)
virtual void ~TObject()
void AbstractMethod(const char* method) const
void AppendPad(Option_t* option)
virtual void Browse(TBrowser* b)
static TClass* Class()
virtual const char* ClassName() const
virtual void Clear(Option_t*)
virtual TObject* Clone() const
virtual Int_t Compare(const TObject* obj) const
virtual void Copy(TObject& object)
virtual void Delete(Option_t* option)
virtual Int_t DistancetoPrimitive(Int_t px, Int_t py)
virtual void Draw(Option_t* option)
virtual void DrawClass() const
virtual void DrawClone(Option_t* option) const
virtual void Dump() const
void Error(const char* method, const char* msgfmt, int) const
virtual void Execute(const char* method, const char* params)
virtual void Execute(TMethod* method, TObjArray* params)
virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py)
void Fatal(const char* method, const char* msgfmt, int) const
virtual TObject* FindObject(const char* name) const
virtual TObject* FindObject(const TObject* obj) const
virtual Option_t* GetDrawOption() const
static Long_t GetDtorOnly()
virtual const char* GetIconName() const
virtual const char* GetName() const
virtual char* GetObjectInfo(Int_t px, Int_t py) const
static Bool_t GetObjectStat()
virtual Option_t* GetOption() const
virtual const char* GetTitle() const
virtual UInt_t GetUniqueID() const
virtual Bool_t HandleTimer(TTimer* timer)
virtual ULong_t Hash() const
virtual Bool_t InheritsFrom(const char* classname) const
virtual Bool_t InheritsFrom(const TClass* cl) const
virtual void Inspect() const
void InvertBit(UInt_t f)
virtual TClass* IsA() const
virtual Bool_t IsEqual(const TObject* obj) const
virtual Bool_t IsFolder() const
Bool_t IsOnHeap() const
virtual Bool_t IsSortable() const
Bool_t IsZombie() const
virtual void ls(Option_t* option) const
void MayNotUse(const char* method) const
virtual Bool_t Notify()
void operator delete(void* ptr)
void* operator new(size_t sz)
void* operator new(size_t sz, void* vp)
TObject& operator=(const TObject& rhs)
virtual void Paint(Option_t* option)
virtual void Pop()
virtual void Print(Option_t* option) const
virtual Int_t Read(const char* name)
virtual void RecursiveRemove(TObject* obj)
void ResetBit(UInt_t f)
virtual void SavePrimitive(ofstream& out, Option_t* option)
void SetBit(UInt_t f, Bool_t set)
void SetBit(UInt_t f)
virtual void SetDrawOption(Option_t* option)
static void SetDtorOnly(void* obj)
static void SetObjectStat(Bool_t stat)
virtual void SetUniqueID(UInt_t uid)
virtual void ShowMembers(TMemberInspector& insp, char* parent)
virtual void Streamer(TBuffer& b)
void StreamerNVirtual(TBuffer& b)
void SysError(const char* method, const char* msgfmt, int) const
Bool_t TestBit(UInt_t f) const
virtual void UseCurrentStyle()
void Warning(const char* method, const char* msgfmt, int) const
virtual Int_t Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)
private:
UInt_t fUniqueID object unique identifier
UInt_t fBits bit field status word
static Long_t fgDtorOnly object for which to call dtor only (i.e. no delete)
static Bool_t fgObjectStat if true keep track of objects in TObjectTable
public:
static const enum TObject:: kIsOnHeap
static const enum TObject:: kNotDeleted
static const enum TObject:: kZombie
static const enum TObject:: kBitMask
static const enum TObject:: kSingleKey
static const enum TObject:: kOverwrite
See also
-
Event, TApplication, TAuthenticate, TBox, TBuffer, TClassTable, TCollection, TCondition, TConditionImp, TDataSetIter, TDictionary, TEllipse, TEnv, TExMap, TFree, TGClient, TGGC, TGLayoutHints, TGLayoutManager, TGMimeTypes, TGObject, TGPicture, TGPicturePool, TGRegion, TGenPhaseSpace, THtml, TInetAddress, TLazyMatrix, TLazyMatrixD, TLegendEntry, TLego, TLine, TLorentzRotation, TLorentzVector, TMCParticle, TMapFile, TMarker, TMarker3DBox, TMatrix, TMatrixColumn, TMatrixD, TMatrixDColumn, TMatrixDDiag, TMatrixDRow, TMatrixDiag, TMatrixRow, TMethodCall, TMonitor, TMutex, TMutexImp, TNamed, TObjString, TObjectTable, TPacketGenerator, TParticle, TPoints3DABC, TPolyLine, TPolyLine3D, TPolyMarker, TPolyMarker3D, TPrimary, TProof, TRWLock, TRealData, TRotation, TSQLResult, TSQLRow, TSQLServer, TSelector, TSemaphore, TSlave, TSplinePoly, TStopwatch, TSysEvtHandler, TTableIter, TThreadImp, TUrl, TVector, TVector2, TVector3, TVectorD, TView, TVirtualFitter, TVirtualHistPainter, TVirtualPad, TVirtualTreePlayer, TVolumePosition, Track
TObject
Mother of all ROOT objects.
The TObject class provides default behaviour and protocol for all
objects in the ROOT system. It provides protocol for object I/O,
error handling, sorting, inspection, printing, drawing, etc.
Every object which inherits from TObject can be stored in the
ROOT collection classes.
TObject()
TObject constructor. It sets the two data words of TObject to their
initial values. The unique ID is set to 0 and the status word is
set depending if the object is created on the stack or allocated
on the heap. Of the status word the high 8 bits are reserved for
system usage and the low 24 bits are user settable. Depending on
the ROOT environment variable "Root.MemStat" (see TEnv.h) the object
is added to the global TObjectTable for bookkeeping.
TObject(const TObject &obj)
TObject copy ctor.
void Copy(TObject &obj)
Copy this to obj.
~TObject()
TObject destructor. Removes object from all canvases and object browsers
iff observer bit is on and remove from the global object table.
void AppendPad(Option_t *option)
Append graphics object to current pad. In case no current pad is set
yet, create a default canvas with the name "c1".
void Browse(TBrowser *)
Browse object (by default we inspect). May be overridden for other default action
const char* ClassName() const
Returns name of class to which the object belongs.
TObject* Clone() const
Make a clone of an object using the Streamer facility.
Int_t Compare(const TObject *) const
Compare abstract method. Must be overridden if a class wants to be able
to compare itself with other objects. Must return -1 if this is smaller
than obj, 0 if objects are equal and 1 if this is larger than obj.
void Delete(Option_t *)
Delete this object. Typically called as a command via the interpreter.
Normally use "delete" operator when object has been allocated on the heap.
Int_t DistancetoPrimitive(Int_t, Int_t)
Computes distance from point (px,py) to the object.
This member function must be implemented for each graphics primitive.
This default function returns a big number (999999).
void Draw(Option_t *option)
Default Draw method for all objects
void DrawClass() const
Draw class inheritance tree of the class to which this object belongs.
If a class B inherits from a class A, description of B is drawn
on the right side of description of A.
Member functions overridden by B are shown in class A with a blue line
crossing-out the corresponding member function.
The following picture is the class inheritance tree of class TPaveLabel:
/*
*/
void DrawClone(Option_t *option) const
Draw a clone of this object in the current pad
void Dump() const
Dump contents of object on stdout.
Using the information in the object dictionary (class TClass)
each data member is interpreted.
If a data member is a pointer, the pointer value is printed
The following output is the Dump of a TArrow object:
fAngle 0 Arrow opening angle (degrees)
fArrowSize 0.2 Arrow Size
fOption.*fData
fX1 0.1 X of 1st point
fY1 0.15 Y of 1st point
fX2 0.67 X of 2nd point
fY2 0.83 Y of 2nd point
fUniqueID 0 object unique identifier
fBits 50331648 bit field status word
fLineColor 1 line color
fLineStyle 1 line style
fLineWidth 1 line width
fFillColor 19 fill area color
fFillStyle 1001 fill area style
void Execute(const char *method, const char *params)
Execute method on this object with the given parameter string, e.g.
"3.14,1,"text"".
void Execute(TMethod *method, TObjArray *params)
Execute method on this object with parameters stored in the TObjArray.
The TObjArray should contain an argv vector like:
argv[0] ... argv[n] = the list of TObjString parameters
void ExecuteEvent(Int_t, Int_t, Int_t)
Execute action corresponding to an event at (px,py). This method
must be overridden if an object can react to graphics events.
TObject* FindObject(const char *) const
must be redefined in derived classes
this function is typycally used with TCollections, but can also be used
to find an object by name inside this object
TObject* FindObject(const TObject *) const
must be redefined in derived classes
this function is typycally used with TCollections, but can also be used
to find an object inside this object
Option_t* GetDrawOption() const
Get option used by the graphics system to draw this object.
const char* GetName() const
Returns name of object. This default method returns the class name.
Classes that give objects a name should override this method.
const char* GetIconName() const
Returns mime type name of object. Used by the TBrowser (via TGMimeTypes
class). Override for class of which you would like to have different
icons for objects of the same class.
UInt_t GetUniqueID() const
Return the unique object id.
char* GetObjectInfo(Int_t px, Int_t py) const
Returns string containing info about the object at position (px,py).
This method is typically overridden by classes of which the objects
can report peculiarities for different positions.
Returned string will be re-used (lock in MT environment).
const char* GetTitle() const
Returns title of object. This default method returns the class title
(i.e. description). Classes that give objects a title should override
this method.
Bool_t HandleTimer(TTimer *)
Execute action in response of a timer timing out. This method
must be overridden if an object has to react to timers.
ULong_t Hash() const
Return hash value for this object.
Bool_t InheritsFrom(const char *classname) const
Returns kTRUE if object inherits from class "classname".
Bool_t InheritsFrom(const TClass *cl) const
Returns kTRUE if object inherits from TClass cl.
void Inspect() const
Dump contents of this object in a graphics canvas.
Same action as Dump but in a graphical form.
In addition pointers to other objects can be followed.
The following picture is the Inspect of a histogram object:
/*
*/
Bool_t IsFolder() const
Returns kTRUE in case object contains browsable objects (like containers
or lists of other objects).
Bool_t IsEqual(const TObject *obj) const
Default equal comparison (objects are equal if they have the same
address in memory). More complicated classes might want to override
this function.
void ls(Option_t *) const
The ls function lists the contents of a class on stdout. Ls output
is typically much less verbose then Dump().
Bool_t Notify()
This method must be overridden to handle object notifcation.
void Paint(Option_t *)
This method must be overridden if a class wants to paint itself.
The difference between Paint() and Draw() is that when a object
draws itself it is added to the display list of the pad in
which it is drawn (and automatically redrawn whenever the pad is
redrawn). While paint just draws the object without adding it to
the pad display list.
void Pop()
Pop on object drawn in a pad to the top of the display list. I.e. it
will be drawn last and on top of all other primitives.
void Print(Option_t *) const
This method must be overridden when a class wants to print itself.
Int_t Read(const char *name)
Read contents of object with specified name from the current directory.
First the key with the given name is searched in the current directory,
next the key buffer is deserialized into the object.
The object must have been created before via the default constructor.
See TObject::Write().
void RecursiveRemove(TObject *)
Recursively remove this object from a list. Typically implemented
by classes that can contain mulitple references to a same object.
void SavePrimitive(ofstream &out, Option_t *)
Save a primitive as a C++ statement(s) on output stream "out".
void SetDrawOption(Option_t *option)
Set drawing option for object. This option only affects
the drawing style and is stored in the option field of the
TObjOptLink supporting a TPad's primitive list (TList).
void SetBit(UInt_t f, Bool_t set)
Set or unset the user status bits as specified in f.
void SetUniqueID(UInt_t uid)
Set the unique object id.
void UseCurrentStyle()
Set current style settings in this object
This function is called when either TCanvas::UseCurrentStyle
or TROOT::ForceStyle have been invoked.
Int_t Write(const char *name, Int_t option, Int_t bufsize)
Write this object to the current directory
The data structure corresponding to this object is serialized.
The corresponding buffer is written to the current directory
with an associated key with name "name".
Writing an object to a file involves the following steps:
-Creation of a support TKey object in the current directory.
The TKey object creates a TBuffer object.
-The TBuffer object is filled via the class::Streamer function.
-If the file is compressed (default) a second buffer is created to
hold the compressed buffer.
-Reservation of the corresponding space in the file by looking
in the TFree list of free blocks of the file.
-The buffer is written to the file.
Bufsize can be given to force a given buffer size to write this object.
By default, the buffersize will be taken from the average buffer size
of all objects written to the current file so far.
If a name is specified, it will be the name of the key.
If name is not given, the name of the key will be the name as returned
by GetName().
The option can be a combination of:
kSingleKey and kOverwrite
Using the kOverwrite option a previous key with the same name is
overwritten.
The kSingleKey option is only used by TCollection::Write() to write
a container with a single key instead of each object in the container
with its own key.
An object is read from the file into memory via TKey::Read() or
via TObject::Read().
void Streamer(TBuffer &R__b)
Stream an object of class TObject.
void Warning(const char *location, const char *va_(fmt), ...) const
Issue warning message. Use "location" to specify the method where the
warning occured. Accepts standard printf formatting arguments.
void Error(const char *location, const char *va_(fmt), ...) const
Issue error message. Use "location" to specify the method where the
error occured. Accepts standard printf formatting arguments.
void SysError(const char *location, const char *va_(fmt), ...) const
Issue system error message. Use "location" to specify the method where
the system error occured. Accepts standard printf formatting arguments.
void Fatal(const char *location, const char *va_(fmt), ...) const
Issue fatal error message. Use "location" to specify the method where the
fatal error occured. Accepts standard printf formatting arguments.
void AbstractMethod(const char *method) const
Use this method to implement an "abstract" method that you don't
want to leave purely abstract.
void MayNotUse(const char *method) const
Use this method to signal that a method (defined in a base class)
may not be called in a derived class (in principle against good
design since a child class should not provide less functionality
than its parent, however, sometimes it is necessary).
Bool_t GetObjectStat()
Get status of object stat flag.
void SetObjectStat(Bool_t stat)
Turn on/off tracking of objects in the TObjectTable.
Long_t GetDtorOnly()
void SetDtorOnly(void *obj)
Inline Functions
void MakeZombie()
TObject& operator=(const TObject& rhs)
void Clear(Option_t*)
Option_t* GetOption() const
Bool_t IsSortable() const
Bool_t IsOnHeap() const
Bool_t IsZombie() const
void* operator new(size_t sz)
void* operator new(size_t sz, void* vp)
void operator delete(void* ptr)
void SetBit(UInt_t f)
void ResetBit(UInt_t f)
Bool_t TestBit(UInt_t f) const
void InvertBit(UInt_t f)
TClass* Class()
TClass* IsA() const
void ShowMembers(TMemberInspector& insp, char* parent)
void StreamerNVirtual(TBuffer& b)
Author: Rene Brun 26/12/94
Last update: root/base:$Name: $:$Id: TObject.cxx,v 1.13 2000/12/13 15:13:45 brun Exp $
Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
ROOT page - Class index - Top of the page
This page has been automatically generated. If you have any comments or suggestions about the page layout send a mail to ROOT support, or contact the developers with any questions or problems regarding ROOT.