1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Generic tabbed dialogs
4 // Author: Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
16 #pragma interface "tabg.h"
19 #define WXTAB_VERSION 1.1
22 #include "wx/string.h"
23 #include "wx/dialog.h"
25 class WXDLLEXPORT wxTabView
;
28 * A wxTabControl is the internal and visual representation
32 class WXDLLEXPORT wxTabControl
: public wxObject
34 DECLARE_DYNAMIC_CLASS(wxTabControl
)
36 wxTabControl(wxTabView
*v
= (wxTabView
*) NULL
);
39 virtual void OnDraw(wxDC
& dc
, bool lastInRow
);
40 inline void SetLabel(const wxString
& str
) { m_controlLabel
= str
; }
41 inline wxString
GetLabel(void) const { return m_controlLabel
; }
43 inline void SetFont(wxFont
*f
) { m_labelFont
= f
; }
44 inline wxFont
*GetFont(void) const { return m_labelFont
; }
46 inline void SetSelected(bool sel
) { m_isSelected
= sel
; }
47 inline bool IsSelected(void) const { return m_isSelected
; }
49 inline void SetPosition(int x
, int y
) { m_offsetX
= x
; m_offsetY
= y
; }
50 inline void SetSize(int x
, int y
) { m_width
= x
; m_height
= y
; }
52 inline void SetRowPosition(int r
) { m_rowPosition
= r
; }
53 inline int GetRowPosition() const { return m_rowPosition
; }
54 inline void SetColPosition(int c
) { m_colPosition
= c
; }
55 inline int GetColPosition() const { return m_colPosition
; }
57 inline int GetX(void) const { return m_offsetX
; }
58 inline int GetY(void) const { return m_offsetY
; }
59 inline int GetWidth(void) const { return m_width
; }
60 inline int GetHeight(void) const { return m_height
; }
62 inline int GetId(void) const { return m_id
; }
63 inline void SetId(int i
) { m_id
= i
; }
65 virtual bool HitTest(int x
, int y
) const ;
69 wxString m_controlLabel
;
72 int m_offsetX
; // Offsets from top-left of tab view area (the area below the tabs)
77 int m_rowPosition
; // Position in row from 0
78 int m_colPosition
; // Position in col from 0
82 * Each wxTabLayer is a list of tabs. E.g. there
83 * are 3 layers in the MS Word Options dialog.
86 class WXDLLEXPORT wxTabLayer
: public wxList
88 DECLARE_DYNAMIC_CLASS(wxTabLayer
)
96 * The wxTabView controls and draws the tabbed object
99 #define wxTAB_STYLE_DRAW_BOX 1 // Draws 3D boxes round tab layers
100 #define wxTAB_STYLE_COLOUR_INTERIOR 2 // Colours interior of tabs, otherwise draws outline
102 class WXDLLEXPORT wxTabView
: public wxObject
104 DECLARE_DYNAMIC_CLASS(wxTabView
)
106 wxTabView(long style
= wxTAB_STYLE_DRAW_BOX
| wxTAB_STYLE_COLOUR_INTERIOR
);
109 inline int GetNumberOfLayers() const { return m_layers
.Number(); }
110 inline wxList
& GetLayers() { return m_layers
; }
112 inline void SetWindow(wxWindow
* wnd
) { m_window
= wnd
; }
113 inline wxWindow
* GetWindow(void) const { return m_window
; }
115 // Automatically positions tabs
116 wxTabControl
*AddTab(int id
, const wxString
& label
, wxTabControl
*existingTab
= (wxTabControl
*) NULL
);
118 void ClearTabs(bool deleteTabs
= TRUE
);
120 // Layout tabs (optional, e.g. if resizing window)
124 virtual void Draw(wxDC
& dc
);
126 // Process mouse event, return FALSE if we didn't process it
127 virtual bool OnEvent(wxMouseEvent
& event
);
129 // Called when a tab is activated
130 virtual void OnTabActivate(int activateId
, int deactivateId
);
132 virtual bool OnTabPreActivate(int WXUNUSED(activateId
), int WXUNUSED(deactivateId
) ) { return TRUE
; };
134 // Allows use of application-supplied wxTabControl classes.
135 virtual wxTabControl
*OnCreateTabControl(void) { return new wxTabControl(this); }
137 void SetHighlightColour(const wxColour
& col
);
138 void SetShadowColour(const wxColour
& col
);
139 void SetBackgroundColour(const wxColour
& col
);
140 inline void SetTextColour(const wxColour
& col
) { m_textColour
= col
; }
142 inline wxColour
GetHighlightColour(void) const { return m_highlightColour
; }
143 inline wxColour
GetShadowColour(void) const { return m_shadowColour
; }
144 inline wxColour
GetBackgroundColour(void) const { return m_backgroundColour
; }
145 inline wxColour
GetTextColour(void) const { return m_textColour
; }
146 inline wxPen
*GetHighlightPen(void) const { return m_highlightPen
; }
147 inline wxPen
*GetShadowPen(void) const { return m_shadowPen
; }
148 inline wxPen
*GetBackgroundPen(void) const { return m_backgroundPen
; }
149 inline wxBrush
*GetBackgroundBrush(void) const { return m_backgroundBrush
; }
151 inline void SetViewRect(const wxRectangle
& rect
) { m_tabViewRect
= rect
; }
152 inline wxRect
GetViewRect(void) const { return m_tabViewRect
; }
154 // Calculate tab width to fit to view, and optionally adjust the view
155 // to fit the tabs exactly.
156 int CalculateTabWidth(int noTabs
, bool adjustView
= FALSE
);
158 inline void SetTabStyle(long style
) { m_tabStyle
= style
; }
159 inline long GetTabStyle(void) const { return m_tabStyle
; }
161 inline void SetTabSize(int w
, int h
) { m_tabWidth
= w
; m_tabHeight
= h
; }
162 inline int GetTabWidth(void) const { return m_tabWidth
; }
163 inline int GetTabHeight(void) const { return m_tabHeight
; }
164 inline void SetTabSelectionHeight(int h
) { m_tabSelectionHeight
= h
; }
165 inline int GetTabSelectionHeight(void) const { return m_tabSelectionHeight
; }
167 // Returns the total height of the tabs component -- this may be several
168 // times the height of a tab, if there are several tab layers (rows).
169 int GetTotalTabHeight();
171 inline int GetTopMargin(void) const { return m_topMargin
; }
172 inline void SetTopMargin(int margin
) { m_topMargin
= margin
; }
174 void SetTabSelection(int sel
, bool activateTool
= TRUE
);
175 inline int GetTabSelection() const { return m_tabSelection
; }
177 // Find tab control for id
178 wxTabControl
*FindTabControlForId(int id
) const ;
180 // Find tab control for layer, position (starting from zero)
181 wxTabControl
*FindTabControlForPosition(int layer
, int position
) const ;
183 inline int GetHorizontalTabOffset() const { return m_tabHorizontalOffset
; }
184 inline int GetHorizontalTabSpacing() const { return m_tabHorizontalSpacing
; }
185 inline void SetHorizontalTabOffset(int sp
) { m_tabHorizontalOffset
= sp
; }
186 inline void SetHorizontalTabSpacing(int sp
) { m_tabHorizontalSpacing
= sp
; }
188 inline void SetVerticalTabTextSpacing(int s
) { m_tabVerticalTextSpacing
= s
; }
189 inline int GetVerticalTabTextSpacing() const { return m_tabVerticalTextSpacing
; }
191 inline wxFont
*GetTabFont() const { return m_tabFont
; }
192 inline void SetTabFont(wxFont
*f
) { m_tabFont
= f
; }
194 inline wxFont
*GetSelectedTabFont() const { return m_tabSelectedFont
; }
195 inline void SetSelectedTabFont(wxFont
*f
) { m_tabSelectedFont
= f
; }
196 // Find the node and the column at which this control is positioned.
197 wxNode
*FindTabNodeAndColumn(wxTabControl
*control
, int *col
) const ;
199 // Do the necessary to change to this tab
200 virtual bool ChangeTab(wxTabControl
*control
);
202 // Move the selected tab to the bottom layer, if necessary,
203 // without calling app activation code
204 bool MoveSelectionTab(wxTabControl
*control
);
206 inline int GetNumberOfTabs() const { return m_noTabs
; }
209 // List of layers, from front to back.
218 // The height of the selected tab
219 int m_tabSelectionHeight
;
224 // Space between tabs
225 int m_tabHorizontalSpacing
;
227 // Space between top of normal tab and text
228 int m_tabVerticalTextSpacing
;
230 // Horizontal offset of each tab row above the first
231 int m_tabHorizontalOffset
;
233 // The distance between the bottom of the first tab row
234 // and the top of the client area (i.e. the margin)
237 // The position and size of the view above which the tabs are placed.
238 // I.e., the internal client area of the sheet.
239 wxRect m_tabViewRect
;
245 wxColour m_highlightColour
;
246 wxColour m_shadowColour
;
247 wxColour m_backgroundColour
;
248 wxColour m_textColour
;
250 // Pen and brush cache
251 wxPen
* m_highlightPen
;
253 wxPen
* m_backgroundPen
;
254 wxBrush
* m_backgroundBrush
;
257 wxFont
* m_tabSelectedFont
;
265 * A dialog box class that is tab-friendly
268 class WXDLLEXPORT wxTabbedDialog
: public wxDialog
270 DECLARE_DYNAMIC_CLASS(wxTabbedDialog
)
274 wxTabbedDialog(wxWindow
*parent
, wxWindowID id
, const wxString
& title
,
275 const wxPoint
& pos
= wxDefaultPosition
,
276 const wxSize
& size
= wxDefaultSize
,
277 long windowStyle
= wxDEFAULT_DIALOG_STYLE
, const wxString
& name
= wxDialogNameStr
);
278 ~wxTabbedDialog(void);
280 inline wxTabView
*GetTabView() const { return m_tabView
; }
281 inline void SetTabView(wxTabView
*v
) { m_tabView
= v
; }
283 void OnCloseWindow(wxCloseEvent
& event
);
284 void OnMouseEvent(wxMouseEvent
& event
);
285 void OnPaint(wxPaintEvent
& event
);
288 wxTabView
* m_tabView
;
290 DECLARE_EVENT_TABLE()
294 * A panel class that is tab-friendly
297 class WXDLLEXPORT wxTabbedPanel
: public wxPanel
299 DECLARE_DYNAMIC_CLASS(wxTabbedPanel
)
303 wxTabbedPanel(wxWindow
*parent
, wxWindowID id
,
304 const wxPoint
& pos
= wxDefaultPosition
,
305 const wxSize
& size
= wxDefaultSize
,
306 long windowStyle
= 0, const wxString
& name
= wxPanelNameStr
);
307 ~wxTabbedPanel(void);
309 inline wxTabView
*GetTabView() const { return m_tabView
; }
310 inline void SetTabView(wxTabView
*v
) { m_tabView
= v
; }
312 void OnMouseEvent(wxMouseEvent
& event
);
313 void OnPaint(wxPaintEvent
& event
);
316 wxTabView
* m_tabView
;
318 DECLARE_EVENT_TABLE()
321 class WXDLLEXPORT wxPanelTabView
: public wxTabView
323 DECLARE_DYNAMIC_CLASS(wxPanelTabView
)
325 wxPanelTabView(wxPanel
*pan
, long style
= wxTAB_STYLE_DRAW_BOX
| wxTAB_STYLE_COLOUR_INTERIOR
);
326 ~wxPanelTabView(void);
328 // Called when a tab is activated
329 virtual void OnTabActivate(int activateId
, int deactivateId
);
331 // Specific to this class
332 void AddTabWindow(int id
, wxWindow
*window
);
333 wxWindow
*GetTabWindow(int id
) const ;
334 void ClearWindows(bool deleteWindows
= TRUE
);
335 inline wxWindow
*GetCurrentWindow() const { return m_currentWindow
; }
337 void ShowWindowForTab(int id
);
338 inline wxList
& GetWindows() const { return (wxList
&) m_tabWindows
; }
341 // List of panels, one for each tab. Indexed
344 wxWindow
* m_currentWindow
;