TCanvas

class TCanvas : public TPad

    private:

           TCanvas TCanvas(TCanvas& canvas)
              void Build()
      virtual void CopyPixmaps()
              void DrawEventStatus(Int_t button, Int_t x, Int_t y, TObject* selected)
          TCanvas& operator=(TCanvas& rhs)

    protected:

              void Constructor()
              void Constructor(Text_t* name, Text_t* title, Int_t form)
              void Constructor(Text_t* name, Text_t* title, Int_t ww, Int_t wh)
              void Constructor(Text_t* name, Text_t* title, Int_t wtopx, Int_t wtopy, Int_t ww, Int_t wh)
              void Destructor()
      virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py)

    public:

                   TCanvas TCanvas()
                   TCanvas TCanvas(Text_t* name, Text_t* title, Int_t form = 1)
                   TCanvas TCanvas(Text_t* name, Text_t* title, Int_t ww, Int_t wh)
                   TCanvas TCanvas(Text_t* name, Text_t* title, Int_t wtopx, Int_t wtopy, Int_t ww, Int_t wh)
                   TCanvas TCanvas(Text_t* name, Int_t ww, Int_t wh, Int_t winid)
              virtual void ~TCanvas()
              virtual void cd(Int_t subpadnumber = 0)
                   TClass* Class()
              virtual void Clear(Option_t* option)
              virtual void Close(Option_t* option)
              virtual void Draw(Option_t* option)
              virtual void EditorBar()
                      void EnterLeave(TPad* prevSelPad, TObject* prevSelObj)
                      void FeedbackMode(Bool_t set)
                      void Flush()
                      void ForceUpdate()
             virtual Int_t GetCanvasID()
               TCanvasImp* GetCanvasImp()
              virtual void GetCanvasPar(Int_t& wtopx, Int_t& wtopy, UInt_t& ww, UInt_t& wh)
             TContextMenu* GetContextMenu()
             const Text_t* GetDISPLAY()
                     Int_t GetDoubleBuffer()
              TControlBar* GetEditorBar()
             virtual Int_t GetEvent()
             virtual Int_t GetEventX()
             virtual Int_t GetEventY()
           virtual Color_t GetHighLightColor()
             virtual void* GetPadDivision(Int_t xdivision = 1, Int_t ydivision = 1)
      virtual TVirtualPad* GetPadSave()
          virtual TObject* GetSelected()
                 Option_t* GetSelectedOpt()
      virtual TVirtualPad* GetSelectedPad()
                    Bool_t GetShowEventStatus()
            virtual UInt_t GetWh()
                    UInt_t GetWindowHeight()
                     Int_t GetWindowTopX()
                     Int_t GetWindowTopY()
                    UInt_t GetWindowWidth()
            virtual UInt_t GetWw()
                    Size_t GetXsizeReal()
                    Size_t GetXsizeUser()
                    Size_t GetYsizeReal()
                    Size_t GetYsizeUser()
              virtual void HandleInput(EEventType button, Int_t x, Int_t y)
                    Bool_t HasMenuBar()
                      void Iconify()
           virtual TClass* IsA()
            virtual Bool_t IsBatch()
           ECanvasEditMode IsEditable()
            virtual Bool_t IsRetained()
              virtual void ls(Option_t* option)
                      void MakeDefCanvas()
                      void MoveOpaque(Int_t set = 1)
            virtual Bool_t OpaqueMoving()
            virtual Bool_t OpaqueResizing()
              virtual void Paint(Option_t* option)
              virtual void Resize(Option_t* option)
                      void ResizeOpaque(Int_t set = 1)
                      void SaveSource(Text_t* filename, Option_t* option)
                      void SetBatch(Bool_t batch = kTRUE)
              virtual void SetCanvasSize(UInt_t ww, UInt_t wh)
              virtual void SetCursor(ECursor cursor)
              virtual void SetDoubleBuffer(Int_t mode = 1)
              virtual void SetEditable(ECanvasEditMode mode = kIsEditable)
                      void SetHighLightColor(Color_t col)
                      void SetRetained(Bool_t retained = kTRUE)
              virtual void SetSelected(TObject* obj)
              virtual void SetTitle(Text_t* title)
                      void SetWindowPosition(Int_t x, Int_t y)
                      void SetWindowSize(UInt_t ww, UInt_t wh)
                      void Show()
              virtual void ShowMembers(TMemberInspector& insp, char* parent)
              virtual void Size(Float_t xsizeuser = 0, Float_t ysizeuser = 0)
              virtual void Streamer(TBuffer& b)
              virtual void ToggleEventStatus()
              virtual void Update()
              virtual void UseCurrentStyle()

  Data Members

    protected:

              TString fDISPLAY          Name of destination screen
                Int_t fDoubleBuffer     Double buffer flag (0=off, 1=on)
               Bool_t fRetained         Retain structure flag
               Size_t fXsizeUser        User specified size of canvas along X in CM
               Size_t fYsizeUser        User specified size of canvas along Y in CM
               Size_t fXsizeReal        Current size of canvas along X in CM
               Size_t fYsizeReal        Current size of canvas along Y in CM
                Int_t fCanvasID         Canvas identifier
                Int_t fWindowTopX       Top X position of window (in pixels)
                Int_t fWindowTopY       Top Y position of window (in pixels)
               UInt_t fWindowWidth      Width of window (including borders, etc.)
               UInt_t fWindowHeight     Height of window (including menubar, borders, etc.)
               UInt_t fCw               Width of the canvas along X (pixels)
               UInt_t fCh               Height of the canvas along Y (pixels)
           TAttCanvas fCatt             Canvas attributes
             TObject* fSelected         Currently selected object
              TString fSelectedOpt      Drawing option of selected object
         TVirtualPad* fSelectedPad      Pad containing currently selected object
         TVirtualPad* fPadSave          Pointer to saved pad in HandleInput
                Int_t fEvent            Type of current or last handled event
                Int_t fEventX           Last X mouse position in canvas
                Int_t fEventY           Last Y mouse position in canvas
               Bool_t fShowEventStatus  Show event status panel
         TControlBar* fEditorBar        Editor control bar
          TCanvasImp* fCanvasImp        Window system specific canvas implementation
               Bool_t fMoveOpaque       Move objects in opaque mode
               Bool_t fResizeOpaque     Resize objects in opaque mode
              Color_t fHighLightColor   Highlight color of active pad
               Bool_t fBatch            True when in batchmode
               Bool_t fMenuBar          False if no menubar is displayed
      ECanvasEditMode fIsEditable       True if canvas is editable
        TContextMenu* fContextMenu      Context menu pointer

See also

TClassTree, TDialogCanvas, TTreeViewer

Class Description

   A Canvas is an area mapped to a window directly under
   the control of the display manager.
   A ROOT session may have several canvases open at any given time.

   A Canvas may be subdivided into independent graphical areas: the PADs
   A canvas has a default pad which has the name of the canvas itself.
   An example of a Canvas layout is sketched in the picture below.

   ***********************************************************************
   *          Tool Bar menus    for Canvas                               *
   ***********************************************************************
   *                                                                     *
   *  ************************************    *************************  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *              P1                  *    *        P2             *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  *                                  *    *                       *  *
   *  ************************************    *************************  *
   *                                                                     *
   ***********************************************************************

   This canvas contains two pads named P1 and P2.
   Both Canvas, P1 and P2 can be moved, grown, shrinked using the
   normal rules of the Display manager.
   A copy of a real canvas with 4 pads is shown in the picture below.

/*

*/


  Once objects have been drawn in a canvas, they can be edited/moved
  by pointing directly to them. The cursor shape is changed
  to suggest the type of action that one can do on this object.
  Clicking with the right mouse button on an object pops-up
  a contextmenu with a complete list of actions possible on this object.

  A graphical editor may be started from the canvas "Edit" menu.
  Select the "Editor" item. This will show the following editor menu.

/*

*/

  For example, to draw a new TText primitive, select the option Text,
  then click at the position where you want to draw the text. Type <CR>
  when you have finished typing the string.

  A canvas may be automatically divided into pads via TPad::Divide.

 Canvas default constructor

 Create an embedded canvas, i.e. a canvas that is in a TGCanvas widget
 which is placed in a TGFrame. This ctor is only called via the
 TRootEmbeddedCanvas class.

*-*-*-*-*-*-*-*-*Canvas constructor using a template*-*-*-*-*-*-*-*-*-*-*-*
*-*              ===================================
  Create a new canvas with a predefined size form.
      if form < 0  the menubar is not shown.

  form = 1    700x500 at 10,10 (set by TStyle::SetCanvasDefH,W,X,Y)
  form = 2    500x500 at 20,20
  form = 3    500x500 at 30,30
  form = 4    500x500 at 40,40
  form = 5    500x500 at 50,50

*-*-*-*-*-*-*-*-*-*-*-*Canvas constructor*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                    ==================
  Create a new canvas at a random position.

  wide is the canvas size in pixels along X
      if ww < 0  the menubar is not shown.
  wh is the canvas size in pixels along Y

*-*-*-*-*-*-*-*-*-*-*-*Canvas constructor*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                    ==================
  Create a new canvas at a random position.

  wide is the canvas size in pixels along X
      if ww < 0  the menubar is not shown.
  wh is the canvas size in pixels along Y

*-*-*-*-*-*-*-*-*-*-*-*Canvas constructor*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                    ==================
  Create a new canvas.

  wtopx,wtopy are the pixel coordinates of the top left corner of the canvas
     if wtopx < 0) the menubar is not shown.
  ww is the canvas size in pixels along X
  wh is the canvas size in pixels along Y

 Build a canvas. Called by all constructors.

*-*-*-*-*-*-*-*-*-*-*Canvas default destructor*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  =========================

*-*-*-*-*-*-*-*-*-*-*-*Set current canvas & pad*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                    ========================

*-*-*-*-*-*-*-*-*-*-*-*Clear canvas*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                    ============
  Remove all primitives in default pad
  Remove all pads (except default pad)

*-*-*-*-*-*-*-*-*-*-*-*Close canvas*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                    ============
  Delete window/pads data structure

*-*-*-*-*-*-*-*-*Copy the canvas pixmap of the pad to the canvas*-*-*-*-*-*-*
*-*              ===============================================

  Draw a canvas.
  If a canvas with the name is already on the screen, the canvas is repainted.
  This function is useful when a canvas object has been saved in a Root file.
  One can then do:
     Root > Tfile f("file.root");
     Root > canvas.Draw();

*-*-*-*-*-*-*Report name and title of primitive below the cursor*-*-*-*-*-*
*-*          ===================================================

    This function is called when the option "Event Status"
    in the canvas menu "Options" is selected.

*-*-*-*-*-*-*-*-*-*-*Create the Editor Controlbar*-*-*-*-*-*-*-*-*-*
*-*                  ============================

 Generate kMouseEnter and kMouseLeave events depending on the previously
 selected object and the currently selected object. Does nothing if the
 selected object does not change.

*-*-*-*-*-*-*-*-*-*-*Execute action corresponding to one event*-*-*-*
*-*                  =========================================
  This member function must be implemented to realize the action
  corresponding to the mouse click on the object in the canvas

  Only handle mouse motion events in TCanvas, all other events are
  ignored for the time being

*-*-*-*-*-*-*-*-*Turn rubberband feedback mode on or off*-*-*-*-*-*-*-*-*-*-*
*-*              =======================================

*-*-*-*-*-*-*-*-*Flush canvas buffers*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              ====================

*-*-*-*-*-*Force a copy of current style for all objects in canvas*-*-*-*-*
*-*        =======================================================

*-*-*-*-*-*-*-*-*Return pad corresponding to one canvas division*-*-*-*-*
*-*              ===============================================

 Returns current top x position of window on screen.

 Returns current top y position of window on screen.

*-*-*-*-*-*-*-*-*-*Handle Input Events*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                ===================
  Handle input events, like button up/down in current canvas.

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*List all pads*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                          =============

*-*-*-*-*-*-*Static function to build a default canvas*-*-*-*-*-*-*-*-*-*-*
*-*          =========================================

*-*-*-*-*-*-*-*-*Set option to move objects/pads in a canvas*-*-*-*-*-*-*-*
*-*              ===========================================

  if set = 1 (default) graphics objects are moved in opaque mode
         = 0 only the outline of objects is drawn when moving them
  The option opaque produces the best effect. It requires however a
  a reasonably fast workstation or response time.

*-*-*-*-*-*-*-*-*Paint canvas*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              ============

*-*-*-*-*-*-*Recompute canvas parameters following a X11 Resize*-*-*-*-*-*-*
*-*          ==================================================

*-*-*-*-*-*-*Save primitives in this canvas as a C++ macro file*-*-*-*-*-*
*-*          ==================================================

 Toggle batch mode. However, if the canvas is created without a window
 then batch mode always stays set.

 Set Width and Height of canvas to ww and wh respectively
 If ww and/or wh are greater than the current canvas window
 a scroll bar is automatically generated.
 Use this function to zoom in a canvas and naviguate via
 the scroll bars.

*-*-*-*-*-*-*-*-*-*-*Set cursor*-*-**-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ==========

*-*-*-*-*-*-*-*-*-*-*Set Double Buffer On/Off*-*-**-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ========================

*-*-*-*-*-*-*-*-*-*-*Set Canvas title*-*-**-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ===============

*-*-*-*-*-*-*Set the canvas scale in centimeters*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*          ===================================
  This information is used by PostScript to set the page size.
  xsize  = size of the canvas in centimeters along X
  ysize  = size of the canvas in centimeters along Y
   if xsize and ysize are not equal to 0, then the scale factors will
   be computed to keep the ratio ysize/xsize independently of the canvas
   size (parts of the physical canvas will be unused).

   if xsize = 0 and ysize is not zero, then xsize will be computed
      to fit to the current canvas scale. If the canvas is resized,
      a new value for xsize will be recomputed. In this case the aspect
      ratio is not preserved.

   if both xsize = 0 and ysize = 0, then the scaling is automatic.
   the largest dimension will be allocated a size of 20 centimeters.

*-*-*-*-*-*-*-*-*Stream a class object*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              =========================================

 Toggle event statusbar.

*-*-*-*-*-*-*-*-*Update canvas pad buffers*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              =========================

Inline Functions

               TCanvas& operator=(TCanvas& rhs)
                TCanvas TCanvas(Text_t* name, Int_t ww, Int_t wh, Int_t winid)
                   void ForceUpdate()
          const Text_t* GetDISPLAY()
          TContextMenu* GetContextMenu()
                  Int_t GetDoubleBuffer()
           TControlBar* GetEditorBar()
                  Int_t GetEvent()
                  Int_t GetEventX()
                  Int_t GetEventY()
                Color_t GetHighLightColor()
           TVirtualPad* GetPadSave()
               TObject* GetSelected()
              Option_t* GetSelectedOpt()
           TVirtualPad* GetSelectedPad()
                 Bool_t GetShowEventStatus()
                 Size_t GetXsizeUser()
                 Size_t GetYsizeUser()
                 Size_t GetXsizeReal()
                 Size_t GetYsizeReal()
                  Int_t GetCanvasID()
            TCanvasImp* GetCanvasImp()
                 UInt_t GetWindowWidth()
                 UInt_t GetWindowHeight()
                 UInt_t GetWw()
                 UInt_t GetWh()
                   void GetCanvasPar(Int_t& wtopx, Int_t& wtopy, UInt_t& ww, UInt_t& wh)
                 Bool_t HasMenuBar()
                   void Iconify()
                 Bool_t IsBatch()
        ECanvasEditMode IsEditable()
                 Bool_t IsRetained()
                 Bool_t OpaqueMoving()
                 Bool_t OpaqueResizing()
                   void ResizeOpaque(Int_t set = 1)
                   void SetWindowPosition(Int_t x, Int_t y)
                   void SetWindowSize(UInt_t ww, UInt_t wh)
                   void SetEditable(ECanvasEditMode mode = kIsEditable)
                   void SetHighLightColor(Color_t col)
                   void SetSelected(TObject* obj)
                   void Show()
                   void SetRetained(Bool_t retained = kTRUE)
                TClass* Class()
                TClass* IsA()
                   void ShowMembers(TMemberInspector& insp, char* parent)