Logo ROOT   6.30.04
Reference Guide
 All Namespaces Files Pages
TGTab.h
Go to the documentation of this file.
1 // @(#)root/gui:$Id$
2 // Author: Fons Rademakers 13/01/98
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 #ifndef ROOT_TGTab
13 #define ROOT_TGTab
14 
15 
16 //////////////////////////////////////////////////////////////////////////
17 // //
18 // TGTab, TGTabElement, TGTabLayout //
19 // //
20 // A tab widget contains a set of composite frames each with a little //
21 // tab with a name (like a set of folders with tabs). //
22 // //
23 // The TGTab is user callable. The TGTabElement and TGTabLayout are //
24 // is a service classes of the tab widget. //
25 // //
26 // Clicking on a tab will bring the associated composite frame to the //
27 // front and generate the following event: //
28 // kC_COMMAND, kCM_TAB, tab id, 0. //
29 // //
30 //////////////////////////////////////////////////////////////////////////
31 
32 #include "TGFrame.h"
33 #include "TGWidget.h"
34 
35 class TList;
36 class TGTabElement;
37 class TGTab;
38 class TGPicture;
39 
40 class TGTabLayout : public TGLayoutManager {
41 
42 protected:
43  TGTab *fMain; // container frame
44  TList *fList; // list of frames to arrange
45 
46 private:
47  TGTabLayout(const TGTabLayout&); // not implemented
48  TGTabLayout& operator=(const TGTabLayout&); // not implemented
49 
50 public:
51  TGTabLayout(TGTab *main);
52 
53  virtual void Layout();
54  virtual TGDimension GetDefaultSize() const;
55  virtual void SavePrimitive(std::ostream &out, Option_t *option = "");
56 
57  ClassDef(TGTabLayout,0) // Layout manager for TGTab widget
58 };
59 
60 
61 
62 class TGTab : public TGCompositeFrame, public TGWidget {
63 
64 protected:
65  Int_t fCurrent; // index of current tab
66  UInt_t fTabh; // tab height
67  TGCompositeFrame *fContainer; // main container
68  TList *fRemoved; // list of removed tabs
69  FontStruct_t fFontStruct; // font
70  GContext_t fNormGC; // drawing context
71 
72  void ChangeTab(Int_t tabIndex, Bool_t emit=kTRUE);
73 
74  static const TGFont *fgDefaultFont;
75  static const TGGC *fgDefaultGC;
76 
77 private:
78  TGTab(const TGTab&); // not implemented
79  TGTab& operator=(const TGTab&); // not implemented
80 
81 public:
82  static FontStruct_t GetDefaultFontStruct();
83  static const TGGC &GetDefaultGC();
84 
85  TGTab(const TGWindow *p = 0, UInt_t w = 1, UInt_t h = 1,
86  GContext_t norm = GetDefaultGC()(),
87  FontStruct_t font = GetDefaultFontStruct(),
88  UInt_t options = kChildFrame,
89  Pixel_t back = GetDefaultFrameBackground());
90  virtual ~TGTab();
91 
92  virtual TGCompositeFrame *AddTab(TGString *text);
93  virtual TGCompositeFrame *AddTab(const char *text);
94  virtual void AddTab(const char *text, TGCompositeFrame *cf);
95  virtual void AddTab(TGString *text, TGCompositeFrame *cf);
96 
97  virtual void NewTab(const char *text = "tab"); // *MENU*icon=bld_newtab.png*
98  virtual void RemoveTab(Int_t tabIndex = -1,
99  Bool_t storeRemoved = kTRUE); // *MENU*icon=bld_removetab.png*
100  virtual Bool_t SetTab(Int_t tabIndex, Bool_t emit = kTRUE);
101  virtual Bool_t SetTab(const char *name, Bool_t emit = kTRUE);
102  virtual void DrawBorder() { }
103 
104  TGCompositeFrame *GetContainer() const { return fContainer; }
105  Int_t GetCurrent() const { return fCurrent; }
106  TGCompositeFrame *GetTabContainer(Int_t tabIndex) const;
107  TGCompositeFrame *GetTabContainer(const char *name) const;
108  TGTabElement *GetTabTab(Int_t tabIndex) const;
109  TGTabElement *GetTabTab(const char *name) const;
110  TGCompositeFrame *GetCurrentContainer() const { return GetTabContainer(fCurrent); }
111  TGTabElement *GetCurrentTab() const { return GetTabTab(fCurrent); }
112  UInt_t GetTabHeight() const { return fTabh; }
113  Int_t GetNumberOfTabs() const;
114  virtual void SetEnabled(Int_t tabIndex, Bool_t on = kTRUE); //*MENU*
115  virtual void SetText(const char *text = "tab"); //*MENU*icon=bld_rename.png*
116  Bool_t IsEnabled(Int_t tabIndex) const;
117 
118  virtual void SavePrimitive(std::ostream &out, Option_t *option = "");
119 
120  virtual void CloseTab(Int_t id) { Emit("CloseTab(Int_t)", id); } //*SIGNAL*
121  virtual void Removed(Int_t id) { Emit("Removed(Int_t)", id); } //*SIGNAL*
122  virtual void Selected(Int_t id) { Emit("Selected(Int_t)", id); } //*SIGNAL*
123  virtual TGLayoutManager *GetLayoutManager() const;
124 
125  ClassDef(TGTab,0) // Tab widget
126 };
127 
128 
129 
130 class TGTabElement : public TGFrame {
131 
132 protected:
133  TGString *fText; // text on tab
134  const TGPicture *fClosePic; // "close tab" icon
135  const TGPicture *fClosePicD; // "close tab" icon (disabled)
136  GContext_t fNormGC; // graphics context for drawing tab
137  FontStruct_t fFontStruct; // font used for tab
138  UInt_t fTWidth; // width of tab text
139  UInt_t fTHeight; // height of tab text
140  Bool_t fEnabled; // enabled or disabled
141  Bool_t fShowClose; // show or hide close icon
142  Bool_t fActive; // true if active (in front)
143 
144 private:
145  TGTabElement(const TGTabElement&); // not implemented
146  TGTabElement& operator=(const TGTabElement&); // not implemented
147 
148 public:
149  TGTabElement(const TGWindow *p = 0, TGString *text = 0, UInt_t w = 1, UInt_t h = 1,
150  GContext_t norm = TGTab::GetDefaultGC()(),
151  FontStruct_t font = TGTab::GetDefaultFontStruct(),
152  UInt_t options = kRaisedFrame,
153  Pixel_t back = GetDefaultFrameBackground());
154  virtual ~TGTabElement();
155 
156  virtual void DrawBorder();
157  virtual TGDimension GetDefaultSize() const;
158  const TGString *GetText() const { return fText; }
159  const char *GetString() const { return fText->GetString(); }
160  virtual Bool_t HandleButton(Event_t *event);
161  void SetText(TGString *text);
162  virtual void SetEnabled(Bool_t on = kTRUE) { fEnabled = on; }
163  Bool_t IsEnabled() const { return fEnabled; }
164  virtual void SetEditDisabled(UInt_t) {}
165  virtual void ShowClose(Bool_t on = kTRUE);
166  Bool_t IsCloseShown() const { return fShowClose; }
167  virtual void SetActive(Bool_t on = kTRUE) { fActive = on; }
168  Bool_t IsActive() const { return fActive; }
169 
170  ClassDef(TGTabElement,0) // Little tab on tab widget
171 };
172 
173 #endif