library: libCore
#include "TExec.h"


class description - source file - inheritance tree (.pdf)

class TExec : public TNamed

Inheritance Chart:

TExec() TExec(const char* name, const char* command) TExec(const TExec& text) virtual ~TExec() static TClass* Class() virtual void Exec(const char* command = "") virtual TClass* IsA() const TExec& operator=(const TExec&) virtual void Paint(Option_t* option = "") virtual void SavePrimitive(ofstream& out, Option_t* option) virtual void SetAction(const char* action) virtual void ShowMembers(TMemberInspector& insp, char* parent) virtual void Streamer(TBuffer& b) void StreamerNVirtual(TBuffer& b)

Data Members

Class Description

   TExec is a utility class that can be used to execute a CINT command
   when some event happens in a pad.
   The command in turn can invoke a CINT macro to paint graphics objects
   at positions depending on the histogram or graph contents.

 case 1
 The TExec object is in the list of pad primitives (after exec.Draw()).
 When the pad is drawn, the TExec::Paint function is called. This function
 will execute the specified command.
 The following example uses the services of the class Aclock created
 in $ROOTSYS/test/Aclock.cxx.
 This examples uses a TTimer to redraw a pad at regular intervals (clock).
 When the clock is updated, a string with the current date&time is drawn.
   Aclock ck(400);
   TDatime dt;
   TText t(.5,.3,"t");
   TExec ex("ex","dt.Set();t.SetTitle(dt.AsString())");

 case 2
 The TExec object may be added to the list of functions of a TH1 or TGraph
 object via hist->GetListOfFunctions()->Add(exec).
 When the histogram (or graph) is drawn, the TExec will be executed.
 If the histogram is made persistent on a file, the TExec object
 is also saved with the histogram. When redrawing the histogram in a
 new session, the TExec will be executed.
     Assume an histogram TH1F *h already filled.
     TExec *ex1 = new TExec("ex1","DoSomething()");
     TExec *ex2 = new TExec("ex2",".x macro.C");
  When the Paint function for the histogram will be called, the "DoSomething"
  function will be called (interpreted or compiled) and also the macro.C.

 case 3
 A TExec object is automatically generated when invoking TPad::AddExec.
 Each pad contains a TList of TExecs (0, 1 or more). When a mouse event
 (motion, click, etc) happens, the pad object executes ssequentially
 this list of TExecs. In the code (interpreted or compiled) executed
 by the TExec referenced command, one can call the pad service functions
 such as TPad::GetEvent, TPad::GetEventX, TPad::GetEventY to find
 which type of event and the X,Y position of the mouse.
 By default, the list of TExecs is executed. This can be disabled
 via the canvas menu "Option".
 See $ROOTSYS/tutorials/exec2.C for an example.
    Root > TFile f("hsimple.root");
    Root > hpxpy.Draw();
    Root > c1.AddExec("ex2",".x exec2.C");
    When moving the mouse in the canvas, a second canvas shows the
    projection along X of the bin corresponding to the Y position
    of the mouse. The resulting histogram is fitted with a gaussian.
    A "dynamic" line shows the current bin position in Y.
    This more elaborated example can be used as a starting point
    to develop more powerful interactive applications exploiting CINT
    as a development engine.

 The 3 options above can be combined.

TExec(): TNamed()
*-*-*-*-*-*-*-*-*-*-*Exec default constructor*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ========================

TExec(const char *name, const char *command) : TNamed(name,command)
*-*-*-*-*-*-*-*-*-*-*Exec normal constructor*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  =======================

*-*-*-*-*-*-*-*-*-*-*Exec default destructor*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  =======================

TExec(const TExec &e) : TNamed(e)

void Exec(const char *command)
*-*-*-*-*-*-*-*-*-*-*Execute the command referenced by this object*-*-*-*
*-*                  =============================================

  if command is given, this command is executed
 otherwise the default command of the object is executed

 if the default command (in the exec title) is empty, an attemp is made
 to execute the exec name if it contains a "." or a "(", otherwise
 the command ".x execname.C" is executed.
 The function returns the result of the user function/script.

void Paint(Option_t *)
*-*-*-*-*-*-*-*-*-*-*Execute the command referenced by this object*-*-*-*
*-*                  =============================================

void SavePrimitive(ofstream &out, Option_t *)
 Save primitive as a C++ statement(s) on output stream out

Inline Functions

               void SetAction(const char* action)
            TClass* Class()
            TClass* IsA() const
               void ShowMembers(TMemberInspector& insp, char* parent)
               void Streamer(TBuffer& b)
               void StreamerNVirtual(TBuffer& b)
             TExec& operator=(const TExec&)

Author: Rene Brun 29/12/99
Last update: root/base:$Name: $:$Id: TExec.cxx,v 1.6 2002/05/18 08:43:29 brun Exp $
Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *

ROOT page - Class index - Class Hierarchy - 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.