ROOT
6.06/09
Reference Guide
|
Base class for several text objects.
See TAttText for a list of text attributes or fonts, and also for a discussion on text speed and font quality.
By default, the text is drawn in the pad coordinates system. One can draw in NDC coordinates [0,1] if the function SetNDC is called for a TText object.
Example:
Public Types | |
enum | { kTextNDC = BIT(14) } |
Used by TMathText. More... | |
Public Types inherited from TObject | |
enum | EStatusBits { kCanDelete = BIT(0), kMustCleanup = BIT(3), kObjInCanvas = BIT(3), kIsReferenced = BIT(4), kHasUUID = BIT(5), kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(13) } |
enum | { kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kBitMask = 0x00ffffff } |
enum | { kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) } |
Public Member Functions | |
TText () | |
TText (Double_t x, Double_t y, const char *text) | |
Text normal constructor. More... | |
TText (Double_t x, Double_t y, const wchar_t *text) | |
Text normal constructor. More... | |
TText (const TText &text) | |
Copy constructor. More... | |
virtual | ~TText () |
Text default destructor. More... | |
void | Copy (TObject &text) const |
Copy this text to text. More... | |
virtual Int_t | DistancetoPrimitive (Int_t px, Int_t py) |
Compute distance from point px,py to a string. More... | |
virtual TText * | DrawText (Double_t x, Double_t y, const char *text) |
Draw this text with new coordinates. More... | |
virtual TText * | DrawText (Double_t x, Double_t y, const wchar_t *text) |
Draw this text with new coordinates. More... | |
virtual TText * | DrawTextNDC (Double_t x, Double_t y, const char *text) |
Draw this text with new coordinates in NDC. More... | |
virtual TText * | DrawTextNDC (Double_t x, Double_t y, const wchar_t *text) |
Draw this text with new coordinates in NDC. More... | |
virtual void | ExecuteEvent (Int_t event, Int_t px, Int_t py) |
Execute action corresponding to one event. More... | |
virtual void | GetControlBox (Int_t x, Int_t y, Double_t theta, Int_t cBoxX[4], Int_t cBoxY[4]) |
Return the text control box. More... | |
Double_t | GetX () const |
virtual void | GetBoundingBox (UInt_t &w, UInt_t &h, Bool_t angle=kFALSE) |
Return text size in pixels. More... | |
virtual void | GetTextAscentDescent (UInt_t &a, UInt_t &d, const char *text) const |
Return text ascent and descent for string text. More... | |
virtual void | GetTextAscentDescent (UInt_t &a, UInt_t &d, const wchar_t *text) const |
Return text ascent and descent for string text. More... | |
virtual void | GetTextExtent (UInt_t &w, UInt_t &h, const char *text) const |
Return text extent for string text. More... | |
virtual void | GetTextExtent (UInt_t &w, UInt_t &h, const wchar_t *text) const |
Return text extent for string text. More... | |
virtual void | GetTextAdvance (UInt_t &a, const char *text, const Bool_t kern=kTRUE) const |
Return text advance for string text if kern is true (default) kerning is taken into account. More... | |
const void * | GetWcsTitle (void) const |
Returns the text as UNICODE. More... | |
Double_t | GetY () const |
virtual void | ls (Option_t *option="") const |
List this text with its attributes. More... | |
virtual void | Paint (Option_t *option="") |
Paint this text with its current attributes. More... | |
virtual void | PaintControlBox (Int_t x, Int_t y, Double_t theta) |
Paint the text control box. More... | |
virtual void | PaintText (Double_t x, Double_t y, const char *text) |
Draw this text with new coordinates. More... | |
virtual void | PaintText (Double_t x, Double_t y, const wchar_t *text) |
Draw this text with new coordinates. More... | |
virtual void | PaintTextNDC (Double_t u, Double_t v, const char *text) |
Draw this text with new coordinates in NDC. More... | |
virtual void | PaintTextNDC (Double_t u, Double_t v, const wchar_t *text) |
Draw this text with new coordinates in NDC. More... | |
virtual void | Print (Option_t *option="") const |
Dump this text with its attributes. More... | |
virtual void | SavePrimitive (std::ostream &out, Option_t *option="") |
Save primitive as a C++ statement(s) on output stream out. More... | |
virtual void | SetMbTitle (const wchar_t *title=L"") |
Change (i.e. set) the title of the TNamed. More... | |
virtual void | SetNDC (Bool_t isNDC=kTRUE) |
Set NDC mode on if isNDC = kTRUE, off otherwise. More... | |
virtual void | SetText (Double_t x, Double_t y, const char *text) |
virtual void | SetText (Double_t x, Double_t y, const wchar_t *text) |
virtual void | SetX (Double_t x) |
virtual void | SetY (Double_t y) |
virtual Rectangle_t | GetBBox () |
Return the "bounding Box" of the Box. More... | |
virtual TPoint | GetBBoxCenter () |
Return the point given by Alignment as 'center'. More... | |
virtual void | SetBBoxCenter (const TPoint &p) |
Set the point given by Alignment as 'center'. More... | |
virtual void | SetBBoxCenterX (const Int_t x) |
Set X coordinate of the point given by Alignment as 'center'. More... | |
virtual void | SetBBoxCenterY (const Int_t y) |
Set Y coordinate of the point given by Alignment as 'center'. More... | |
virtual void | SetBBoxX1 (const Int_t x) |
Set left hand side of BoundingBox to a value (resize in x direction on left) More... | |
virtual void | SetBBoxX2 (const Int_t x) |
Set right hand side of BoundingBox to a value (resize in x direction on right) More... | |
virtual void | SetBBoxY1 (const Int_t y) |
Set top of BoundingBox to a value (resize in y direction on top) More... | |
virtual void | SetBBoxY2 (const Int_t y) |
Set bottom of BoundingBox to a value (resize in y direction on bottom) More... | |
Public Member Functions inherited from TNamed | |
TNamed () | |
TNamed (const char *name, const char *title) | |
TNamed (const TString &name, const TString &title) | |
TNamed (const TNamed &named) | |
TNamed & | operator= (const TNamed &rhs) |
TNamed assignment operator. More... | |
virtual | ~TNamed () |
virtual void | Clear (Option_t *option="") |
Set name and title to empty strings (""). More... | |
virtual TObject * | Clone (const char *newname="") const |
Make a clone of an object using the Streamer facility. More... | |
virtual Int_t | Compare (const TObject *obj) const |
Compare two TNamed objects. More... | |
virtual void | FillBuffer (char *&buffer) |
Encode TNamed into output buffer. More... | |
virtual const char * | GetName () const |
Returns name of object. More... | |
virtual const char * | GetTitle () const |
Returns title of object. More... | |
virtual ULong_t | Hash () const |
Return hash value for this object. More... | |
virtual Bool_t | IsSortable () const |
virtual void | SetName (const char *name) |
Change (i.e. More... | |
virtual void | SetNameTitle (const char *name, const char *title) |
Change (i.e. set) all the TNamed parameters (name and title). More... | |
virtual void | SetTitle (const char *title="") |
Change (i.e. set) the title of the TNamed. More... | |
virtual Int_t | Sizeof () const |
Return size of the TNamed part of the TObject. More... | |
Public Member Functions inherited from TObject | |
TObject () | |
TObject (const TObject &object) | |
TObject copy ctor. More... | |
TObject & | operator= (const TObject &rhs) |
TObject assignment operator. More... | |
virtual | ~TObject () |
TObject destructor. More... | |
virtual void | AppendPad (Option_t *option="") |
Append graphics object to current pad. More... | |
virtual void | Browse (TBrowser *b) |
Browse object. May be overridden for another default action. More... | |
virtual const char * | ClassName () const |
Returns name of class to which the object belongs. More... | |
virtual void | Delete (Option_t *option="") |
Delete this object. More... | |
virtual void | Draw (Option_t *option="") |
Default Draw method for all objects. More... | |
virtual void | DrawClass () const |
Draw class inheritance tree of the class to which this object belongs. More... | |
virtual TObject * | DrawClone (Option_t *option="") const |
Draw a clone of this object in the current pad. More... | |
virtual void | Dump () const |
Dump contents of object on stdout. More... | |
virtual void | Execute (const char *method, const char *params, Int_t *error=0) |
Execute method on this object with the given parameter string, e.g. More... | |
virtual void | Execute (TMethod *method, TObjArray *params, Int_t *error=0) |
Execute method on this object with parameters stored in the TObjArray. More... | |
virtual TObject * | FindObject (const char *name) const |
Must be redefined in derived classes. More... | |
virtual TObject * | FindObject (const TObject *obj) const |
Must be redefined in derived classes. More... | |
virtual Option_t * | GetDrawOption () const |
Get option used by the graphics system to draw this object. More... | |
virtual UInt_t | GetUniqueID () const |
Return the unique object id. More... | |
virtual const char * | GetIconName () const |
Returns mime type name of object. More... | |
virtual Option_t * | GetOption () const |
virtual char * | GetObjectInfo (Int_t px, Int_t py) const |
Returns string containing info about the object at position (px,py). More... | |
virtual Bool_t | HandleTimer (TTimer *timer) |
Execute action in response of a timer timing out. More... | |
virtual Bool_t | InheritsFrom (const char *classname) const |
Returns kTRUE if object inherits from class "classname". More... | |
virtual Bool_t | InheritsFrom (const TClass *cl) const |
Returns kTRUE if object inherits from TClass cl. More... | |
virtual void | Inspect () const |
Dump contents of this object in a graphics canvas. More... | |
virtual Bool_t | IsFolder () const |
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More... | |
virtual Bool_t | IsEqual (const TObject *obj) const |
Default equal comparison (objects are equal if they have the same address in memory). More... | |
Bool_t | IsOnHeap () const |
Bool_t | IsZombie () const |
virtual Bool_t | Notify () |
This method must be overridden to handle object notification. More... | |
virtual void | Pop () |
Pop on object drawn in a pad to the top of the display list. More... | |
virtual Int_t | Read (const char *name) |
Read contents of object with specified name from the current directory. More... | |
virtual void | RecursiveRemove (TObject *obj) |
Recursively remove this object from a list. More... | |
virtual void | SaveAs (const char *filename="", Option_t *option="") const |
Save this object in the file specified by filename. More... | |
virtual void | SetDrawOption (Option_t *option="") |
Set drawing option for object. More... | |
virtual void | SetUniqueID (UInt_t uid) |
Set the unique object id. More... | |
virtual void | UseCurrentStyle () |
Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More... | |
virtual Int_t | Write (const char *name=0, Int_t option=0, Int_t bufsize=0) |
Write this object to the current directory. More... | |
virtual Int_t | Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const |
Write this object to the current directory. More... | |
void * | operator new (size_t sz) |
void * | operator new[] (size_t sz) |
void * | operator new (size_t sz, void *vp) |
void * | operator new[] (size_t sz, void *vp) |
void | operator delete (void *ptr) |
Operator delete. More... | |
void | operator delete[] (void *ptr) |
Operator delete []. More... | |
void | SetBit (UInt_t f, Bool_t set) |
Set or unset the user status bits as specified in f. More... | |
void | SetBit (UInt_t f) |
void | ResetBit (UInt_t f) |
Bool_t | TestBit (UInt_t f) const |
Int_t | TestBits (UInt_t f) const |
void | InvertBit (UInt_t f) |
virtual void | Info (const char *method, const char *msgfmt,...) const |
Issue info message. More... | |
virtual void | Warning (const char *method, const char *msgfmt,...) const |
Issue warning message. More... | |
virtual void | Error (const char *method, const char *msgfmt,...) const |
Issue error message. More... | |
virtual void | SysError (const char *method, const char *msgfmt,...) const |
Issue system error message. More... | |
virtual void | Fatal (const char *method, const char *msgfmt,...) const |
Issue fatal error message. More... | |
void | AbstractMethod (const char *method) const |
Use this method to implement an "abstract" method that you don't want to leave purely abstract. More... | |
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). More... | |
void | Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const |
Use this method to declare a method obsolete. More... | |
Public Member Functions inherited from TAttText | |
TAttText () | |
TAttText (Int_t align, Float_t angle, Color_t color, Style_t font, Float_t tsize) | |
AttText normal constructor. More... | |
virtual | ~TAttText () |
AttText destructor. More... | |
void | Copy (TAttText &atttext) const |
Copy this text attributes to a new TAttText. More... | |
virtual Short_t | GetTextAlign () const |
virtual Float_t | GetTextAngle () const |
virtual Color_t | GetTextColor () const |
virtual Font_t | GetTextFont () const |
virtual Float_t | GetTextSize () const |
virtual void | Modify () |
Change current text attributes if necessary. More... | |
virtual void | ResetAttText (Option_t *toption="") |
Reset this text attributes to default values. More... | |
virtual void | SaveTextAttributes (std::ostream &out, const char *name, Int_t alidef=12, Float_t angdef=0, Int_t coldef=1, Int_t fondef=61, Float_t sizdef=1) |
Save text attributes as C++ statement(s) on output stream out. More... | |
virtual void | SetTextAttributes () |
Invoke the DialogCanvas Text attributes. More... | |
virtual void | SetTextAlign (Short_t align=11) |
virtual void | SetTextAngle (Float_t tangle=0) |
virtual void | SetTextColor (Color_t tcolor=1) |
virtual void | SetTextColorAlpha (Color_t tcolor, Float_t talpha) |
Set a transparent marker color. More... | |
virtual void | SetTextFont (Font_t tfont=62) |
virtual void | SetTextSize (Float_t tsize=1) |
virtual void | SetTextSizePixels (Int_t npixels) |
Set the text size in pixels. More... | |
Public Member Functions inherited from TAttBBox2D | |
virtual | ~TAttBBox2D () |
ClassDef (TAttBBox2D, 0) | |
Protected Attributes | |
Double_t | fX |
Double_t | fY |
void * | fWcsTitle |
Protected Attributes inherited from TNamed | |
TString | fName |
TString | fTitle |
Protected Attributes inherited from TAttText | |
Float_t | fTextAngle |
Float_t | fTextSize |
Short_t | fTextAlign |
Color_t | fTextColor |
Font_t | fTextFont |
Additional Inherited Members | |
Static Public Member Functions inherited from TObject | |
static Long_t | GetDtorOnly () |
Return destructor only flag. More... | |
static void | SetDtorOnly (void *obj) |
Set destructor only flag. More... | |
static Bool_t | GetObjectStat () |
Get status of object stat flag. More... | |
static void | SetObjectStat (Bool_t stat) |
Turn on/off tracking of objects in the TObjectTable. More... | |
Protected Member Functions inherited from TObject | |
void | MakeZombie () |
virtual void | DoError (int level, const char *location, const char *fmt, va_list va) const |
Interface to ErrorHandler (protected). More... | |
#include <TText.h>
TText::TText | ( | ) |
Referenced by DrawText().
Copy this text to text.
Reimplemented from TNamed.
Definition at line 107 of file TText.cxx.
Referenced by TMathText::Copy(), and TLatex::Copy().
Compute distance from point px,py to a string.
The rectangle surrounding this string is evaluated. If the point (px,py) is in the rectangle, the distance is set to zero.
Reimplemented from TObject.
Definition at line 140 of file TText.cxx.
Referenced by TTreePerfStats::DistancetoPrimitive().
Draw this text with new coordinates.
Definition at line 171 of file TText.cxx.
Referenced by accents(), bars(), TMarker::DisplayMarkerTypes(), TGenerator::Draw(), TMVA::draw_input_labels(), TPad::DrawColorTable(), DrawTextNDC(), fractions(), TInspectCanvas::InspectObject(), itbold(), kalman_do(), kerning(), mathsymbols(), roots(), TMemStatShow::Show(), slash(), splitline(), style(), subsupscript(), and subsupscript2().
Draw this text with new coordinates in NDC.
Definition at line 197 of file TText.cxx.
Referenced by TMVA::boostcontrolplots(), TMVA::draw_network(), and TMVA::DrawMLPoutputMovie().
|
virtual |
Return the "bounding Box" of the Box.
Implements TAttBBox2D.
|
virtual |
Return the point given by Alignment as 'center'.
Implements TAttBBox2D.
Return text size in pixels.
By default the size returned does not take into account the text angle (angle = kFALSE). If angle is set to kTRUE w and h take the angle into account.
Reimplemented in TLatex, and TMathText.
Definition at line 469 of file TText.cxx.
Referenced by GetBBox(), and GetControlBox().
|
virtual |
Return the text control box.
The text position coordinates is (x,y) and the text angle is theta. The control box coordinates are returned in cBoxX and cBoxY.
Definition at line 419 of file TText.cxx.
Referenced by DistancetoPrimitive(), ExecuteEvent(), GetBoundingBox(), TLatex::GetBoundingBox(), and PaintControlBox().
|
virtual |
Return text advance for string text if kern is true (default) kerning is taken into account.
If it is false the kerning is not taken into account.
Definition at line 611 of file TText.cxx.
Referenced by TPDF::Text(), and TPostScript::Text().
Return text ascent and descent for string text.
Definition at line 519 of file TText.cxx.
Referenced by TLatex::Analyse().
Return text extent for string text.
Definition at line 583 of file TText.cxx.
Referenced by TLatex::Analyse(), TPaveLabel::PaintPaveLabel(), TPDF::Text(), and TPostScript::Text().
Returns the text as UNICODE.
Definition at line 126 of file TText.cxx.
Referenced by TASImage::DrawText().
|
inline |
Definition at line 68 of file TText.h.
Referenced by TPaveStats::Paint(), TPaveText::PaintPrimitives(), TRecorderRecording::RecordText(), TPaveText::SaveLines(), and TTextEditor::SetModel().
|
inline |
Definition at line 76 of file TText.h.
Referenced by TPaveText::GetObject(), TPaveStats::Paint(), TPaveText::PaintPrimitives(), TRecorderRecording::RecordText(), TPaveText::SaveLines(), and TTextEditor::SetModel().
Paint the text control box.
(x,y) are the coordinates where the control box should be painted and theta is the angle of the box.
Definition at line 687 of file TText.cxx.
Referenced by ExecuteEvent().
Draw this text with new coordinates.
Definition at line 740 of file TText.cxx.
Referenced by TLatex::Analyse(), TColorWheel::Paint(), TColorWheel::PaintCircle(), TColorWheel::PaintCircles(), TColorWheel::PaintGray(), TGraphPolargram::PaintPolarDivisions(), TPaveText::PaintPrimitives(), and TColorWheel::PaintRectangles().
Draw this text with new coordinates in NDC.
Definition at line 758 of file TText.cxx.
Referenced by TGaxis::PaintAxis().
Dump this text with its attributes.
Reimplemented from TNamed.
Definition at line 776 of file TText.cxx.
Referenced by write(), and writeTrack().
Set the point given by Alignment as 'center'.
Implements TAttBBox2D.
Set X coordinate of the point given by Alignment as 'center'.
Implements TAttBBox2D.
Set Y coordinate of the point given by Alignment as 'center'.
Implements TAttBBox2D.
Set left hand side of BoundingBox to a value (resize in x direction on left)
Implements TAttBBox2D.
Set right hand side of BoundingBox to a value (resize in x direction on right)
Implements TAttBBox2D.
Set top of BoundingBox to a value (resize in y direction on top)
Implements TAttBBox2D.
Set bottom of BoundingBox to a value (resize in y direction on bottom)
Implements TAttBBox2D.
|
virtual |
Set NDC mode on if isNDC = kTRUE, off otherwise.
Definition at line 809 of file TText.cxx.
Referenced by TMVA::correlations(), TMVA::correlationsMultiClass(), TMVA::StatDialogMVAEffs::DrawHistograms(), TLatex::DrawLatex(), TLatex::DrawLatexNDC(), TMathText::DrawMathText(), DrawText(), DrawTextNDC(), ExecuteEvent(), TMVA::mvas(), TTreePerfStats::Paint(), TLegend::PaintPrimitives(), TMemStatShow::Show(), TMVA::variables(), and TMVA::variablesMultiClass().
Definition at line 89 of file TText.h.
Referenced by TDocLatexDirective::GetBoundingBox(), TGaxis::PaintAxis(), TParallelCoordVar::PaintLabels(), TMVA::StatDialogMVAEffs::PrintResults(), and TCreatePrimitives::Text().
Definition at line 91 of file TText.h.
Referenced by TTextEditor::DoXpos(), ExecuteEvent(), TPaveStats::Paint(), TPaveText::PaintPrimitives(), SetBBoxCenter(), and SetBBoxCenterX().
Definition at line 92 of file TText.h.
Referenced by TTextEditor::DoYpos(), ExecuteEvent(), TPaveStats::Paint(), TPaveText::PaintPrimitives(), SetBBoxCenter(), and SetBBoxCenterY().
|
protected |
|
protected |
Definition at line 45 of file TText.h.
Referenced by TLatex::Analyse(), Copy(), DistancetoPrimitive(), TLatex::DrawCircle(), TLatex::DrawLine(), TLatex::DrawParenthesis(), ExecuteEvent(), GetBBox(), GetBBoxCenter(), GetBoundingBox(), TLatex::GetBoundingBox(), GetX(), ls(), TMathText::Paint(), Paint(), TLatex::Paint(), TLatex::PaintLatex1(), Print(), TMathText::SavePrimitive(), SavePrimitive(), TLatex::SavePrimitive(), and TText().
|
protected |
Definition at line 46 of file TText.h.
Referenced by TLatex::Analyse(), Copy(), DistancetoPrimitive(), TLatex::DrawCircle(), TLatex::DrawLine(), TLatex::DrawParenthesis(), ExecuteEvent(), GetBBox(), GetBBoxCenter(), GetBoundingBox(), TLatex::GetBoundingBox(), GetY(), ls(), TMathText::Paint(), Paint(), TLatex::Paint(), TLatex::PaintLatex1(), Print(), TMathText::SavePrimitive(), SavePrimitive(), TLatex::SavePrimitive(), and TText().