b5dbe15d0b
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@47254 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
360 lines
12 KiB
C++
360 lines
12 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: tabg.h
|
|
// Purpose: Generic tabbed dialogs
|
|
// Author: Julian Smart
|
|
// Modified by:
|
|
// Created: 01/02/97
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) Julian Smart
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef __TABGH_G__
|
|
#define __TABGH_G__
|
|
|
|
#define WXTAB_VERSION 1.1
|
|
|
|
#include "wx/hashmap.h"
|
|
#include "wx/string.h"
|
|
#include "wx/dialog.h"
|
|
#include "wx/panel.h"
|
|
#include "wx/list.h"
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxTabView;
|
|
|
|
/*
|
|
* A wxTabControl is the internal and visual representation
|
|
* of the tab.
|
|
*/
|
|
|
|
class WXDLLEXPORT wxTabControl: public wxObject
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxTabControl)
|
|
public:
|
|
wxTabControl(wxTabView *v = (wxTabView *) NULL);
|
|
virtual ~wxTabControl(void);
|
|
|
|
virtual void OnDraw(wxDC& dc, bool lastInRow);
|
|
void SetLabel(const wxString& str) { m_controlLabel = str; }
|
|
wxString GetLabel(void) const { return m_controlLabel; }
|
|
|
|
void SetFont(const wxFont& f) { m_labelFont = f; }
|
|
wxFont *GetFont(void) const { return (wxFont*) & m_labelFont; }
|
|
|
|
void SetSelected(bool sel) { m_isSelected = sel; }
|
|
bool IsSelected(void) const { return m_isSelected; }
|
|
|
|
void SetPosition(int x, int y) { m_offsetX = x; m_offsetY = y; }
|
|
void SetSize(int x, int y) { m_width = x; m_height = y; }
|
|
|
|
void SetRowPosition(int r) { m_rowPosition = r; }
|
|
int GetRowPosition() const { return m_rowPosition; }
|
|
void SetColPosition(int c) { m_colPosition = c; }
|
|
int GetColPosition() const { return m_colPosition; }
|
|
|
|
int GetX(void) const { return m_offsetX; }
|
|
int GetY(void) const { return m_offsetY; }
|
|
int GetWidth(void) const { return m_width; }
|
|
int GetHeight(void) const { return m_height; }
|
|
|
|
int GetId(void) const { return m_id; }
|
|
void SetId(int i) { m_id = i; }
|
|
|
|
virtual bool HitTest(int x, int y) const ;
|
|
|
|
protected:
|
|
wxTabView* m_view;
|
|
wxString m_controlLabel;
|
|
bool m_isSelected;
|
|
wxFont m_labelFont;
|
|
int m_offsetX; // Offsets from top-left of tab view area (the area below the tabs)
|
|
int m_offsetY;
|
|
int m_width;
|
|
int m_height;
|
|
int m_id;
|
|
int m_rowPosition; // Position in row from 0
|
|
int m_colPosition; // Position in col from 0
|
|
};
|
|
|
|
/*
|
|
* Each wxTabLayer is a list of tabs. E.g. there
|
|
* are 3 layers in the MS Word Options dialog.
|
|
*/
|
|
|
|
class WXDLLEXPORT wxTabLayer: public wxList
|
|
{
|
|
};
|
|
|
|
/*
|
|
* The wxTabView controls and draws the tabbed object
|
|
*/
|
|
|
|
WX_DECLARE_LIST(wxTabLayer, wxTabLayerList);
|
|
|
|
#define wxTAB_STYLE_DRAW_BOX 1 // Draws 3D boxes round tab layers
|
|
#define wxTAB_STYLE_COLOUR_INTERIOR 2 // Colours interior of tabs, otherwise draws outline
|
|
|
|
class WXDLLEXPORT wxTabView: public wxObject
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxTabView)
|
|
public:
|
|
wxTabView(long style = wxTAB_STYLE_DRAW_BOX | wxTAB_STYLE_COLOUR_INTERIOR);
|
|
virtual ~wxTabView();
|
|
|
|
inline int GetNumberOfLayers() const { return m_layers.GetCount(); }
|
|
inline wxTabLayerList& GetLayers() { return m_layers; }
|
|
|
|
inline void SetWindow(wxWindow* wnd) { m_window = wnd; }
|
|
inline wxWindow* GetWindow(void) const { return m_window; }
|
|
|
|
// Automatically positions tabs
|
|
wxTabControl *AddTab(int id, const wxString& label, wxTabControl *existingTab = (wxTabControl *) NULL);
|
|
|
|
// Remove the tab without deleting the window
|
|
bool RemoveTab(int id);
|
|
|
|
void ClearTabs(bool deleteTabs = true);
|
|
|
|
bool SetTabText(int id, const wxString& label);
|
|
wxString GetTabText(int id) const;
|
|
|
|
// Layout tabs (optional, e.g. if resizing window)
|
|
void LayoutTabs();
|
|
|
|
// Draw all tabs
|
|
virtual void Draw(wxDC& dc);
|
|
|
|
// Process mouse event, return false if we didn't process it
|
|
virtual bool OnEvent(wxMouseEvent& event);
|
|
|
|
// Called when a tab is activated
|
|
virtual void OnTabActivate(int activateId, int deactivateId);
|
|
// Allows vetoing
|
|
virtual bool OnTabPreActivate(int WXUNUSED(activateId), int WXUNUSED(deactivateId) ) { return true; };
|
|
|
|
// Allows use of application-supplied wxTabControl classes.
|
|
virtual wxTabControl *OnCreateTabControl(void) { return new wxTabControl(this); }
|
|
|
|
void SetHighlightColour(const wxColour& col);
|
|
void SetShadowColour(const wxColour& col);
|
|
void SetBackgroundColour(const wxColour& col);
|
|
inline void SetTextColour(const wxColour& col) { m_textColour = col; }
|
|
|
|
inline wxColour GetHighlightColour(void) const { return m_highlightColour; }
|
|
inline wxColour GetShadowColour(void) const { return m_shadowColour; }
|
|
inline wxColour GetBackgroundColour(void) const { return m_backgroundColour; }
|
|
inline wxColour GetTextColour(void) const { return m_textColour; }
|
|
inline const wxPen *GetHighlightPen(void) const { return m_highlightPen; }
|
|
inline const wxPen *GetShadowPen(void) const { return m_shadowPen; }
|
|
inline const wxPen *GetBackgroundPen(void) const { return m_backgroundPen; }
|
|
inline const wxBrush *GetBackgroundBrush(void) const { return m_backgroundBrush; }
|
|
|
|
inline void SetViewRect(const wxRect& rect) { m_tabViewRect = rect; }
|
|
inline wxRect GetViewRect(void) const { return m_tabViewRect; }
|
|
|
|
// Calculate tab width to fit to view, and optionally adjust the view
|
|
// to fit the tabs exactly.
|
|
int CalculateTabWidth(int noTabs, bool adjustView = false);
|
|
|
|
inline void SetTabStyle(long style) { m_tabStyle = style; }
|
|
inline long GetTabStyle(void) const { return m_tabStyle; }
|
|
|
|
inline void SetTabSize(int w, int h) { m_tabWidth = w; m_tabHeight = h; }
|
|
inline int GetTabWidth(void) const { return m_tabWidth; }
|
|
inline int GetTabHeight(void) const { return m_tabHeight; }
|
|
inline void SetTabSelectionHeight(int h) { m_tabSelectionHeight = h; }
|
|
inline int GetTabSelectionHeight(void) const { return m_tabSelectionHeight; }
|
|
|
|
// Returns the total height of the tabs component -- this may be several
|
|
// times the height of a tab, if there are several tab layers (rows).
|
|
int GetTotalTabHeight();
|
|
|
|
inline int GetTopMargin(void) const { return m_topMargin; }
|
|
inline void SetTopMargin(int margin) { m_topMargin = margin; }
|
|
|
|
void SetTabSelection(int sel, bool activateTool = true);
|
|
inline int GetTabSelection() const { return m_tabSelection; }
|
|
|
|
// Find tab control for id
|
|
wxTabControl *FindTabControlForId(int id) const ;
|
|
|
|
// Find tab control for layer, position (starting from zero)
|
|
wxTabControl *FindTabControlForPosition(int layer, int position) const ;
|
|
|
|
inline int GetHorizontalTabOffset() const { return m_tabHorizontalOffset; }
|
|
inline int GetHorizontalTabSpacing() const { return m_tabHorizontalSpacing; }
|
|
inline void SetHorizontalTabOffset(int sp) { m_tabHorizontalOffset = sp; }
|
|
inline void SetHorizontalTabSpacing(int sp) { m_tabHorizontalSpacing = sp; }
|
|
|
|
inline void SetVerticalTabTextSpacing(int s) { m_tabVerticalTextSpacing = s; }
|
|
inline int GetVerticalTabTextSpacing() const { return m_tabVerticalTextSpacing; }
|
|
|
|
inline wxFont *GetTabFont() const { return (wxFont*) & m_tabFont; }
|
|
inline void SetTabFont(const wxFont& f) { m_tabFont = f; }
|
|
|
|
inline wxFont *GetSelectedTabFont() const { return (wxFont*) & m_tabSelectedFont; }
|
|
inline void SetSelectedTabFont(const wxFont& f) { m_tabSelectedFont = f; }
|
|
// Find the node and the column at which this control is positioned.
|
|
wxList::compatibility_iterator FindTabNodeAndColumn(wxTabControl *control, int *col) const ;
|
|
|
|
// Do the necessary to change to this tab
|
|
virtual bool ChangeTab(wxTabControl *control);
|
|
|
|
// Move the selected tab to the bottom layer, if necessary,
|
|
// without calling app activation code
|
|
bool MoveSelectionTab(wxTabControl *control);
|
|
|
|
inline int GetNumberOfTabs() const { return m_noTabs; }
|
|
|
|
protected:
|
|
// List of layers, from front to back.
|
|
wxTabLayerList m_layers;
|
|
|
|
// Selected tab
|
|
int m_tabSelection;
|
|
|
|
// Usual tab height
|
|
int m_tabHeight;
|
|
|
|
// The height of the selected tab
|
|
int m_tabSelectionHeight;
|
|
|
|
// Usual tab width
|
|
int m_tabWidth;
|
|
|
|
// Space between tabs
|
|
int m_tabHorizontalSpacing;
|
|
|
|
// Space between top of normal tab and text
|
|
int m_tabVerticalTextSpacing;
|
|
|
|
// Horizontal offset of each tab row above the first
|
|
int m_tabHorizontalOffset;
|
|
|
|
// The distance between the bottom of the first tab row
|
|
// and the top of the client area (i.e. the margin)
|
|
int m_topMargin;
|
|
|
|
// The position and size of the view above which the tabs are placed.
|
|
// I.e., the internal client area of the sheet.
|
|
wxRect m_tabViewRect;
|
|
|
|
// Bitlist of styles
|
|
long m_tabStyle;
|
|
|
|
// Colours
|
|
wxColour m_highlightColour;
|
|
wxColour m_shadowColour;
|
|
wxColour m_backgroundColour;
|
|
wxColour m_textColour;
|
|
|
|
// Pen and brush cache
|
|
const wxPen* m_highlightPen;
|
|
const wxPen* m_shadowPen;
|
|
const wxPen* m_backgroundPen;
|
|
const wxBrush* m_backgroundBrush;
|
|
|
|
wxFont m_tabFont;
|
|
wxFont m_tabSelectedFont;
|
|
|
|
int m_noTabs;
|
|
|
|
wxWindow* m_window;
|
|
};
|
|
|
|
/*
|
|
* A dialog box class that is tab-friendly
|
|
*/
|
|
|
|
class WXDLLEXPORT wxTabbedDialog : public wxDialog
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxTabbedDialog)
|
|
|
|
public:
|
|
wxTabbedDialog(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxString& title,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long windowStyle = wxDEFAULT_DIALOG_STYLE,
|
|
const wxString& name = wxDialogNameStr);
|
|
virtual ~wxTabbedDialog();
|
|
|
|
wxTabView *GetTabView() const { return m_tabView; }
|
|
void SetTabView(wxTabView *v) { m_tabView = v; }
|
|
|
|
void OnCloseWindow(wxCloseEvent& event);
|
|
void OnMouseEvent(wxMouseEvent& event);
|
|
void OnPaint(wxPaintEvent& event);
|
|
|
|
protected:
|
|
wxTabView* m_tabView;
|
|
|
|
private:
|
|
DECLARE_EVENT_TABLE()
|
|
};
|
|
|
|
/*
|
|
* A panel class that is tab-friendly
|
|
*/
|
|
|
|
class WXDLLEXPORT wxTabbedPanel : public wxPanel
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxTabbedPanel)
|
|
|
|
public:
|
|
wxTabbedPanel(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long windowStyle = 0,
|
|
const wxString& name = wxPanelNameStr);
|
|
virtual ~wxTabbedPanel();
|
|
|
|
wxTabView *GetTabView() const { return m_tabView; }
|
|
void SetTabView(wxTabView *v) { m_tabView = v; }
|
|
|
|
void OnMouseEvent(wxMouseEvent& event);
|
|
void OnPaint(wxPaintEvent& event);
|
|
|
|
protected:
|
|
wxTabView* m_tabView;
|
|
|
|
private:
|
|
DECLARE_EVENT_TABLE()
|
|
};
|
|
|
|
WX_DECLARE_HASH_MAP(int, wxWindow*, wxIntegerHash, wxIntegerEqual,
|
|
wxIntToWindowHashMap);
|
|
|
|
class WXDLLEXPORT wxPanelTabView : public wxTabView
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxPanelTabView)
|
|
|
|
public:
|
|
wxPanelTabView(wxPanel *pan, long style = wxTAB_STYLE_DRAW_BOX | wxTAB_STYLE_COLOUR_INTERIOR);
|
|
virtual ~wxPanelTabView(void);
|
|
|
|
// Called when a tab is activated
|
|
virtual void OnTabActivate(int activateId, int deactivateId);
|
|
|
|
// Specific to this class
|
|
void AddTabWindow(int id, wxWindow *window);
|
|
wxWindow *GetTabWindow(int id) const ;
|
|
void ClearWindows(bool deleteWindows = true);
|
|
wxWindow *GetCurrentWindow() const { return m_currentWindow; }
|
|
|
|
void ShowWindowForTab(int id);
|
|
// wxList& GetWindows() const { return (wxList&) m_tabWindows; }
|
|
|
|
protected:
|
|
// List of panels, one for each tab. Indexed
|
|
// by tab ID.
|
|
wxIntToWindowHashMap m_tabWindows;
|
|
wxWindow* m_currentWindow;
|
|
wxPanel* m_panel;
|
|
};
|
|
|
|
#endif
|
|
|