1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxGrid and related classes
4 // Author: Michael Bedward (based on code by Julian Smart, Robin Dunn)
8 // Copyright: (c) Michael Bedward
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
15 #if !defined(wxUSE_NEW_GRID) || !(wxUSE_NEW_GRID)
23 #pragma interface "grid.h"
27 #include "wx/scrolwin.h"
28 #include "wx/string.h"
29 #include "wx/scrolbar.h"
31 #include "wx/textctrl.h"
32 #include "wx/combobox.h"
33 #include "wx/dynarray.h"
36 // Default parameters for wxGrid
38 #define WXGRID_DEFAULT_NUMBER_ROWS 10
39 #define WXGRID_DEFAULT_NUMBER_COLS 10
41 #define WXGRID_DEFAULT_ROW_HEIGHT 25
43 #define WXGRID_DEFAULT_ROW_HEIGHT 30
45 #define WXGRID_DEFAULT_COL_WIDTH 80
46 #define WXGRID_DEFAULT_COL_LABEL_HEIGHT 32
47 #define WXGRID_DEFAULT_ROW_LABEL_WIDTH 82
48 #define WXGRID_LABEL_EDGE_ZONE 5
49 #define WXGRID_MIN_ROW_HEIGHT 15
50 #define WXGRID_MIN_COL_WIDTH 15
51 #define WXGRID_DEFAULT_SCROLLBAR_WIDTH 16
54 class WXDLLEXPORT wxGrid
;
57 //////////////////////////////////////////////////////////////////////
61 //////////////////////////////////////////////////////////////////////
64 class WXDLLEXPORT wxGridTableBase
: public wxObject
68 virtual ~wxGridTableBase();
70 // You must override these functions in a derived table class
72 virtual long GetNumberRows() = 0;
73 virtual long GetNumberCols() = 0;
74 virtual wxString
GetValue( int row
, int col
) = 0;
75 virtual void SetValue( int row
, int col
, const wxString
& s
) = 0;
76 virtual bool IsEmptyCell( int row
, int col
) = 0;
78 // Overriding these is optional
80 virtual void SetView( wxGrid
*grid
) { m_view
= grid
; }
81 virtual wxGrid
* GetView() const { return m_view
; }
83 virtual void Clear() {}
84 virtual bool InsertRows( size_t pos
= 0, size_t numRows
= 1 );
85 virtual bool AppendRows( size_t numRows
= 1 );
86 virtual bool DeleteRows( size_t pos
= 0, size_t numRows
= 1 );
87 virtual bool InsertCols( size_t pos
= 0, size_t numCols
= 1 );
88 virtual bool AppendCols( size_t numCols
= 1 );
89 virtual bool DeleteCols( size_t pos
= 0, size_t numCols
= 1 );
91 virtual wxString
GetRowLabelValue( int row
);
92 virtual wxString
GetColLabelValue( int col
);
93 virtual void SetRowLabelValue( int WXUNUSED(row
), const wxString
& ) {}
94 virtual void SetColLabelValue( int WXUNUSED(col
), const wxString
& ) {}
99 DECLARE_ABSTRACT_CLASS( wxGridTableBase
);
104 // IDs for messages sent from grid table to view
106 enum wxGridTableRequest
108 wxGRIDTABLE_REQUEST_VIEW_GET_VALUES
= 2000,
109 wxGRIDTABLE_REQUEST_VIEW_SEND_VALUES
,
110 wxGRIDTABLE_NOTIFY_ROWS_INSERTED
,
111 wxGRIDTABLE_NOTIFY_ROWS_APPENDED
,
112 wxGRIDTABLE_NOTIFY_ROWS_DELETED
,
113 wxGRIDTABLE_NOTIFY_COLS_INSERTED
,
114 wxGRIDTABLE_NOTIFY_COLS_APPENDED
,
115 wxGRIDTABLE_NOTIFY_COLS_DELETED
118 class WXDLLEXPORT wxGridTableMessage
121 wxGridTableMessage();
122 wxGridTableMessage( wxGridTableBase
*table
, int id
,
126 void SetTableObject( wxGridTableBase
*table
) { m_table
= table
; }
127 wxGridTableBase
* GetTableObject() const { return m_table
; }
128 void SetId( int id
) { m_id
= id
; }
129 int GetId() { return m_id
; }
130 void SetCommandInt( int comInt1
) { m_comInt1
= comInt1
; }
131 int GetCommandInt() { return m_comInt1
; }
132 void SetCommandInt2( int comInt2
) { m_comInt2
= comInt2
; }
133 int GetCommandInt2() { return m_comInt2
; }
136 wxGridTableBase
*m_table
;
144 // ------ wxGridStringArray
145 // A 2-dimensional array of strings for data values
148 WX_DECLARE_EXPORTED_OBJARRAY(wxArrayString
, wxGridStringArray
);
152 // ------ wxGridStringTable
154 // Simplest type of data table for a grid for small tables of strings
155 // that are stored in memory
158 class WXDLLEXPORT wxGridStringTable
: public wxGridTableBase
162 wxGridStringTable( int numRows
, int numCols
);
163 ~wxGridStringTable();
165 // these are pure virtual in wxGridTableBase
167 long GetNumberRows();
168 long GetNumberCols();
169 wxString
GetValue( int row
, int col
);
170 void SetValue( int row
, int col
, const wxString
& s
);
171 bool IsEmptyCell( int row
, int col
);
173 // overridden functions from wxGridTableBase
176 bool InsertRows( size_t pos
= 0, size_t numRows
= 1 );
177 bool AppendRows( size_t numRows
= 1 );
178 bool DeleteRows( size_t pos
= 0, size_t numRows
= 1 );
179 bool InsertCols( size_t pos
= 0, size_t numCols
= 1 );
180 bool AppendCols( size_t numCols
= 1 );
181 bool DeleteCols( size_t pos
= 0, size_t numCols
= 1 );
183 void SetRowLabelValue( int row
, const wxString
& );
184 void SetColLabelValue( int col
, const wxString
& );
185 wxString
GetRowLabelValue( int row
);
186 wxString
GetColLabelValue( int col
);
189 wxGridStringArray m_data
;
191 // These only get used if you set your own labels, otherwise the
192 // GetRow/ColLabelValue functions return wxGridTableBase defaults
194 wxArrayString m_rowLabels
;
195 wxArrayString m_colLabels
;
197 DECLARE_DYNAMIC_CLASS( wxGridStringTable
)
202 //////////////////////////////////////////////////////////////////////
206 //////////////////////////////////////////////////////////////////////
208 class WXDLLEXPORT wxGridCellCoords
211 wxGridCellCoords() { m_row
= m_col
= -1; }
212 wxGridCellCoords( int r
, int c
) { m_row
= r
; m_col
= c
; }
214 // default copy ctor is ok
216 long GetRow() const { return m_row
; }
217 void SetRow( long n
) { m_row
= n
; }
218 long GetCol() const { return m_col
; }
219 void SetCol( long n
) { m_col
= n
; }
220 void Set( long row
, long col
) { m_row
= row
; m_col
= col
; }
222 wxGridCellCoords
& operator=( const wxGridCellCoords
& other
)
224 if ( &other
!= this )
232 bool operator==( const wxGridCellCoords
& other
)
234 return (m_row
== other
.m_row
&& m_col
== other
.m_col
);
237 bool operator!=( const wxGridCellCoords
& other
)
239 return (m_row
!= other
.m_row
|| m_col
!= other
.m_col
);
244 return (m_row
== -1 && m_col
== -1 );
253 // For comparisons...
255 extern wxGridCellCoords wxGridNoCellCoords
;
256 extern wxRect wxGridNoCellRect
;
258 // An array of cell coords...
260 WX_DECLARE_EXPORTED_OBJARRAY(wxGridCellCoords
, wxGridCellCoordsArray
);
264 // This set of classes is to provide for the use of different types of
265 // cell edit controls in the grid while avoiding the wx class info
266 // system in deference to wxPython
268 class WXDLLEXPORT wxGridTextCtrl
: public wxTextCtrl
272 wxGridTextCtrl( wxWindow
*,
276 const wxString
& value
= wxEmptyString
,
277 const wxPoint
& pos
= wxDefaultPosition
,
278 const wxSize
& size
= wxDefaultSize
,
281 void SetStartValue( const wxString
& );
282 wxString
GetStartValue() { return startValue
; }
287 // TRUE for controls placed over cells,
288 // FALSE for a control on a grid control panel
289 bool m_isCellControl
;
293 void OnKeyDown( wxKeyEvent
& );
295 DECLARE_DYNAMIC_CLASS( wxGridTextCtrl
)
296 DECLARE_EVENT_TABLE()
300 class WXDLLEXPORT wxGridRowLabelWindow
: public wxWindow
303 wxGridRowLabelWindow() { m_owner
= (wxGrid
*)NULL
; }
304 wxGridRowLabelWindow( wxGrid
*parent
, wxWindowID id
,
305 const wxPoint
&pos
, const wxSize
&size
);
310 void OnPaint( wxPaintEvent
& event
);
311 void OnMouseEvent( wxMouseEvent
& event
);
312 void OnKeyDown( wxKeyEvent
& event
);
314 DECLARE_DYNAMIC_CLASS(wxGridRowLabelWindow
)
315 DECLARE_EVENT_TABLE()
319 class WXDLLEXPORT wxGridColLabelWindow
: public wxWindow
322 wxGridColLabelWindow() { m_owner
= (wxGrid
*)NULL
; }
323 wxGridColLabelWindow( wxGrid
*parent
, wxWindowID id
,
324 const wxPoint
&pos
, const wxSize
&size
);
329 void OnPaint( wxPaintEvent
&event
);
330 void OnMouseEvent( wxMouseEvent
& event
);
331 void OnKeyDown( wxKeyEvent
& event
);
333 DECLARE_DYNAMIC_CLASS(wxGridColLabelWindow
)
334 DECLARE_EVENT_TABLE()
338 class WXDLLEXPORT wxGridCornerLabelWindow
: public wxWindow
341 wxGridCornerLabelWindow() { m_owner
= (wxGrid
*)NULL
; }
342 wxGridCornerLabelWindow( wxGrid
*parent
, wxWindowID id
,
343 const wxPoint
&pos
, const wxSize
&size
);
348 void OnMouseEvent( wxMouseEvent
& event
);
349 void OnKeyDown( wxKeyEvent
& event
);
350 void OnPaint( wxPaintEvent
& event
);
352 DECLARE_DYNAMIC_CLASS(wxGridCornerLabelWindow
)
353 DECLARE_EVENT_TABLE()
358 class WXDLLEXPORT wxGridWindow
: public wxPanel
363 m_owner
= (wxGrid
*)NULL
;
364 m_rowLabelWin
= (wxGridRowLabelWindow
*)NULL
;
365 m_colLabelWin
= (wxGridColLabelWindow
*)NULL
;
368 wxGridWindow( wxGrid
*parent
,
369 wxGridRowLabelWindow
*rowLblWin
,
370 wxGridColLabelWindow
*colLblWin
,
371 wxWindowID id
, const wxPoint
&pos
, const wxSize
&size
);
374 void ScrollWindow( int dx
, int dy
, const wxRect
*rect
);
378 wxGridRowLabelWindow
*m_rowLabelWin
;
379 wxGridColLabelWindow
*m_colLabelWin
;
381 void OnPaint( wxPaintEvent
&event
);
382 void OnMouseEvent( wxMouseEvent
& event
);
383 void OnKeyDown( wxKeyEvent
& );
385 DECLARE_DYNAMIC_CLASS(wxGridWindow
)
386 DECLARE_EVENT_TABLE()
391 class WXDLLEXPORT wxGrid
: public wxScrolledWindow
396 m_table
= (wxGridTableBase
*) NULL
;
397 m_gridWin
= (wxGridWindow
*) NULL
;
398 m_rowLabelWin
= (wxGridRowLabelWindow
*) NULL
;
399 m_colLabelWin
= (wxGridColLabelWindow
*) NULL
;
400 m_cornerLabelWin
= (wxGridCornerLabelWindow
*) NULL
;
401 m_cellEditCtrl
= (wxWindow
*) NULL
;
404 wxGrid( wxWindow
*parent
,
406 const wxPoint
& pos
= wxDefaultPosition
,
407 const wxSize
& size
= wxDefaultSize
,
409 const wxString
& name
= wxPanelNameStr
);
413 bool CreateGrid( int numRows
, int numCols
);
416 // ------ grid dimensions
418 int GetNumberRows() { return m_numRows
; }
419 int GetNumberCols() { return m_numCols
; }
422 // ------ display update functions
424 void CalcRowLabelsExposed( wxRegion
& reg
);
425 void CalcColLabelsExposed( wxRegion
& reg
);
426 void CalcCellsExposed( wxRegion
& reg
);
429 // ------ event handlers
431 void ProcessRowLabelMouseEvent( wxMouseEvent
& event
);
432 void ProcessColLabelMouseEvent( wxMouseEvent
& event
);
433 void ProcessCornerLabelMouseEvent( wxMouseEvent
& event
);
434 void ProcessGridCellMouseEvent( wxMouseEvent
& event
);
435 bool ProcessTableMessage( wxGridTableMessage
& );
438 wxGridTableBase
* GetTable() const { return m_table
; }
439 void SetTable( wxGridTableBase
*table
) { m_table
= table
; }
442 bool InsertRows( int pos
= 0, int numRows
= 1, bool updateLabels
=TRUE
);
443 bool AppendRows( int numRows
= 1, bool updateLabels
=TRUE
);
444 bool DeleteRows( int pos
= 0, int numRows
= 1, bool updateLabels
=TRUE
);
445 bool InsertCols( int pos
= 0, int numCols
= 1, bool updateLabels
=TRUE
);
446 bool AppendCols( int numCols
= 1, bool updateLabels
=TRUE
);
447 bool DeleteCols( int pos
= 0, int numCols
= 1, bool updateLabels
=TRUE
);
449 void DrawGridCellArea( wxDC
& dc
);
450 void DrawCellBorder( wxDC
& dc
, const wxGridCellCoords
& );
451 void DrawAllGridLines( wxDC
& dc
); // TODO - delete this ?
452 void DrawCell( wxDC
& dc
, const wxGridCellCoords
& );
453 void DrawCellBackground( wxDC
& dc
, const wxGridCellCoords
& );
454 void DrawCellValue( wxDC
& dc
, const wxGridCellCoords
& );
456 void DrawRowLabels( wxDC
& dc
);
457 void DrawRowLabel( wxDC
& dc
, int row
);
458 void DrawColLabels( wxDC
& dc
);
459 void DrawColLabel( wxDC
& dc
, int col
);
462 // ------ Cell text drawing functions
464 void DrawTextRectangle( wxDC
& dc
, const wxString
&, const wxRect
&,
465 int horizontalAlignment
= wxLEFT
,
466 int verticalAlignment
= wxTOP
);
468 // Split a string containing newline chararcters into an array of
469 // strings and return the number of lines
471 void StringToLines( const wxString
& value
, wxArrayString
& lines
);
473 void GetTextBoxSize( wxDC
& dc
,
474 wxArrayString
& lines
,
475 long *width
, long *height
);
479 // Code that does a lot of grid modification can be enclosed
480 // between BeginBatch() and EndBatch() calls to avoid screen
483 void BeginBatch() { m_batchCount
++; }
484 void EndBatch() { if ( m_batchCount
> 0 ) m_batchCount
--; }
485 int GetBatchCount() { return m_batchCount
; }
488 // ------ edit control functions
490 bool IsEditable() { return m_editable
; }
491 void EnableEditing( bool edit
);
493 #if 0 // at the moment the cell edit control is always active
494 void EnableCellEditControl( bool enable
);
497 bool IsCellEditControlEnabled()
498 { return (m_cellEditCtrl
&& m_cellEditCtrlEnabled
); }
500 void ShowCellEditControl();
501 void HideCellEditControl();
502 void SetEditControlValue( const wxString
& s
= wxEmptyString
);
503 void SaveEditControlValue();
506 // ------ grid location functions
507 // Note that all of these functions work with the logical coordinates of
508 // grid cells and labels so you will need to convert from device
509 // coordinates for mouse events etc.
511 void XYToCell( int x
, int y
, wxGridCellCoords
& );
515 int YToEdgeOfRow( int y
);
516 int XToEdgeOfCol( int x
);
518 wxRect
CellToRect( int row
, int col
);
519 wxRect
CellToRect( const wxGridCellCoords
& coords
)
520 { return CellToRect( coords
.GetRow(), coords
.GetCol() ); }
522 int GetGridCursorRow() { return m_currentCellCoords
.GetRow(); }
523 int GetGridCursorCol() { return m_currentCellCoords
.GetCol(); }
525 // check to see if a cell is either wholly visible (the default arg) or
526 // at least partially visible in the grid window
528 bool IsVisible( int row
, int col
, bool wholeCellVisible
= TRUE
);
529 bool IsVisible( const wxGridCellCoords
& coords
, bool wholeCellVisible
= TRUE
)
530 { return IsVisible( coords
.GetRow(), coords
.GetCol(), wholeCellVisible
); }
531 void MakeCellVisible( int row
, int col
);
532 void MakeCellVisible( const wxGridCellCoords
& coords
)
533 { MakeCellVisible( coords
.GetRow(), coords
.GetCol() ); }
536 // ------ grid cursor movement functions
538 void SetGridCursor( int row
, int col
)
539 { SetCurrentCell( wxGridCellCoords(row
, col
) ); }
542 bool MoveCursorDown();
543 bool MoveCursorLeft();
544 bool MoveCursorRight();
547 bool MoveCursorUpBlock();
548 bool MoveCursorDownBlock();
549 bool MoveCursorLeftBlock();
550 bool MoveCursorRightBlock();
553 // ------ label and gridline formatting
555 int GetDefaultRowLabelSize() { return WXGRID_DEFAULT_ROW_LABEL_WIDTH
; }
556 int GetRowLabelSize() { return m_rowLabelWidth
; }
557 int GetDefaultColLabelSize() { return WXGRID_DEFAULT_COL_LABEL_HEIGHT
; }
558 int GetColLabelSize() { return m_colLabelHeight
; }
559 wxColour
GetLabelBackgroundColour() { return m_labelBackgroundColour
; }
560 wxColour
GetLabelTextColour() { return m_labelTextColour
; }
561 wxFont
GetLabelFont() { return m_labelFont
; }
562 void GetRowLabelAlignment( int *horiz
, int *vert
);
563 void GetColLabelAlignment( int *horiz
, int *vert
);
564 wxString
GetRowLabelValue( int row
);
565 wxString
GetColLabelValue( int col
);
566 wxColour
GetGridLineColour() { return m_gridLineColour
; }
568 void SetRowLabelSize( int width
);
569 void SetColLabelSize( int height
);
570 void SetLabelBackgroundColour( const wxColour
& );
571 void SetLabelTextColour( const wxColour
& );
572 void SetLabelFont( const wxFont
& );
573 void SetRowLabelAlignment( int horiz
, int vert
);
574 void SetColLabelAlignment( int horiz
, int vert
);
575 void SetRowLabelValue( int row
, const wxString
& );
576 void SetColLabelValue( int col
, const wxString
& );
577 void SetGridLineColour( const wxColour
& );
579 void EnableGridLines( bool enable
= TRUE
);
580 bool GridLinesEnabled() { return m_gridLinesEnabled
; }
583 // ------ row and col formatting
585 int GetDefaultRowSize();
586 int GetRowSize( int row
);
587 int GetDefaultColSize();
588 int GetColSize( int col
);
589 wxColour
GetDefaultCellBackgroundColour();
590 wxColour
GetCellBackgroundColour( int row
, int col
);
591 wxColour
GetDefaultCellTextColour();
592 wxColour
GetCellTextColour( int row
, int col
);
593 wxFont
GetDefaultCellFont();
594 wxFont
GetCellFont( int row
, int col
);
595 void GetDefaultCellAlignment( int *horiz
, int *vert
);
596 void GetCellAlignment( int row
, int col
, int *horiz
, int *vert
);
598 void SetDefaultRowSize( int height
, bool resizeExistingRows
= FALSE
);
599 void SetRowSize( int row
, int height
);
600 void SetDefaultColSize( int width
, bool resizeExistingCols
= FALSE
);
601 void SetColSize( int col
, int width
);
602 void SetDefaultCellBackgroundColour( const wxColour
& );
603 void SetCellBackgroundColour( int row
, int col
, const wxColour
& );
604 void SetDefaultCellTextColour( const wxColour
& );
605 void SetCellTextColour( int row
, int col
, const wxColour
& );
606 void SetDefaultCellFont( const wxFont
& );
607 void SetCellFont( int row
, int col
, const wxFont
& );
608 void SetDefaultCellAlignment( int horiz
, int vert
);
609 void SetCellAlignment( int row
, int col
, int horiz
, int vert
);
612 // ------ cell value accessors
614 wxString
GetCellValue( int row
, int col
)
618 return m_table
->GetValue( row
, col
);
622 return wxEmptyString
;
626 wxString
GetCellValue( const wxGridCellCoords
& coords
)
627 { return GetCellValue( coords
.GetRow(), coords
.GetCol() ); }
629 void SetCellValue( int row
, int col
, const wxString
& s
);
630 void SetCellValue( const wxGridCellCoords
& coords
, const wxString
& s
)
631 { SetCellValue( coords
.GetRow(), coords
.GetCol(), s
); }
635 // ------ selections of blocks of cells
637 void SelectRow( int row
, bool addToSelected
= FALSE
);
638 void SelectCol( int col
, bool addToSelected
= FALSE
);
640 void SelectBlock( int topRow
, int leftCol
, int bottomRow
, int rightCol
);
642 void SelectBlock( const wxGridCellCoords
& topLeft
,
643 const wxGridCellCoords
& bottomRight
)
644 { SelectBlock( topLeft
.GetRow(), topLeft
.GetCol(),
645 bottomRight
.GetRow(), bottomRight
.GetCol() ); }
650 { return ( m_selectedTopLeft
!= wxGridNoCellCoords
&&
651 m_selectedBottomRight
!= wxGridNoCellCoords
);
654 void ClearSelection();
656 bool IsInSelection( int row
, int col
)
657 { return ( IsSelection() &&
658 row
>= m_selectedTopLeft
.GetRow() &&
659 col
>= m_selectedTopLeft
.GetCol() &&
660 row
<= m_selectedBottomRight
.GetRow() &&
661 col
<= m_selectedBottomRight
.GetCol() );
664 bool IsInSelection( const wxGridCellCoords
& coords
)
665 { return IsInSelection( coords
.GetRow(), coords
.GetCol() ); }
667 void GetSelection( int* topRow
, int* leftCol
, int* bottomRow
, int* rightCol
)
669 // these will all be -1 if there is no selected block
671 *topRow
= m_selectedTopLeft
.GetRow();
672 *leftCol
= m_selectedTopLeft
.GetCol();
673 *bottomRow
= m_selectedBottomRight
.GetRow();
674 *rightCol
= m_selectedBottomRight
.GetCol();
678 // This function returns the rectangle that encloses the block of cells
679 // limited by TopLeft and BottomRight cell in device coords and clipped
680 // to the client size of the grid window.
682 wxRect
BlockToDeviceRect( const wxGridCellCoords
& topLeft
,
683 const wxGridCellCoords
& bottomRight
);
685 // This function returns the rectangle that encloses the selected cells
686 // in device coords and clipped to the client size of the grid window.
688 wxRect
SelectionToDeviceRect()
690 return BlockToDeviceRect( m_selectedTopLeft
,
691 m_selectedBottomRight
);
695 // ------ For compatibility with previous wxGrid only...
697 // ************************************************
698 // ** Don't use these in new code because they **
699 // ** are liable to disappear in a future **
701 // ************************************************
704 wxGrid( wxWindow
*parent
,
705 int x
= -1, int y
= -1, int w
= -1, int h
= -1,
707 const wxString
& name
= wxPanelNameStr
)
708 : wxScrolledWindow( parent
, -1, wxPoint(x
,y
), wxSize(w
,h
), style
, name
)
713 void SetCellValue( const wxString
& val
, int row
, int col
)
714 { SetCellValue( row
, col
, val
); }
716 void UpdateDimensions()
717 { CalcDimensions(); }
719 int GetRows() { return GetNumberRows(); }
720 int GetCols() { return GetNumberCols(); }
721 int GetCursorRow() { return GetGridCursorRow(); }
722 int GetCursorColumn() { return GetGridCursorCol(); }
724 int GetScrollPosX() { return 0; }
725 int GetScrollPosY() { return 0; }
727 void SetScrollX( int x
) { }
728 void SetScrollY( int y
) { }
730 void SetColumnWidth( int col
, int width
)
731 { SetColSize( col
, width
); }
733 int GetColumnWidth( int col
)
734 { return GetColSize( col
); }
736 void SetRowHeight( int row
, int height
)
737 { SetRowSize( row
, height
); }
739 int GetRowHeight( int row
)
740 { return GetRowSize( row
); }
742 int GetViewHeight() // returned num whole rows visible
745 int GetViewWidth() // returned num whole cols visible
748 void SetLabelSize( int orientation
, int sz
)
750 if ( orientation
== wxHORIZONTAL
)
751 SetColLabelSize( sz
);
753 SetRowLabelSize( sz
);
756 int GetLabelSize( int orientation
)
758 if ( orientation
== wxHORIZONTAL
)
759 return GetColLabelSize();
761 return GetRowLabelSize();
764 void SetLabelAlignment( int orientation
, int align
)
766 if ( orientation
== wxHORIZONTAL
)
767 SetColLabelAlignment( align
, -1 );
769 SetRowLabelAlignment( align
, -1 );
772 int GetLabelAlignment( int orientation
, int WXUNUSED(align
) )
775 if ( orientation
== wxHORIZONTAL
)
777 GetColLabelAlignment( &h
, &v
);
782 GetRowLabelAlignment( &h
, &v
);
787 void SetLabelValue( int orientation
, const wxString
& val
, int pos
)
789 if ( orientation
== wxHORIZONTAL
)
790 SetColLabelValue( pos
, val
);
792 SetRowLabelValue( pos
, val
);
795 wxString
GetLabelValue( int orientation
, int pos
)
797 if ( orientation
== wxHORIZONTAL
)
798 return GetColLabelValue( pos
);
800 return GetRowLabelValue( pos
);
803 wxFont
GetCellTextFont() const
804 { return m_defaultCellFont
; }
806 wxFont
GetCellTextFont(int WXUNUSED(row
), int WXUNUSED(col
)) const
807 { return m_defaultCellFont
; }
809 void SetCellTextFont(const wxFont
& fnt
)
810 { SetDefaultCellFont( fnt
); }
812 void SetCellTextFont(const wxFont
& fnt
, int row
, int col
)
813 { SetCellFont( row
, col
, fnt
); }
815 void SetCellTextColour(const wxColour
& val
, int row
, int col
)
816 { SetCellTextColour( row
, col
, val
); }
818 void SetCellTextColour(const wxColour
& col
)
819 { SetDefaultCellTextColour( col
); }
821 void SetCellBackgroundColour(const wxColour
& col
)
822 { SetDefaultCellBackgroundColour( col
); }
824 void SetCellBackgroundColour(const wxColour
& colour
, int row
, int col
)
825 { SetCellBackgroundColour( row
, col
, colour
); }
827 bool GetEditable() { return IsEditable(); }
828 void SetEditable( bool edit
= TRUE
) { EnableEditing( edit
); }
829 bool GetEditInPlace() { return IsCellEditControlEnabled(); }
830 void SetEditInPlace(bool edit
= TRUE
) { }
832 void SetCellAlignment( int align
, int row
, int col
)
833 { SetCellAlignment(row
, col
, align
, wxCENTER
); }
834 void SetCellAlignment( int WXUNUSED(align
) ) {}
835 void SetCellBitmap(wxBitmap
*WXUNUSED(bitmap
), int WXUNUSED(row
), int WXUNUSED(col
))
837 void SetDividerPen(const wxPen
& WXUNUSED(pen
)) { }
838 wxPen
& GetDividerPen() const { return wxNullPen
; }
839 void OnActivate(bool WXUNUSED(active
)) {}
841 // ******** End of compatibility functions **********
845 // ------ control IDs
846 enum { wxGRID_CELLCTRL
= 2000,
849 // ------ control types
850 enum { wxGRID_TEXTCTRL
= 2100,
858 wxGridWindow
*m_gridWin
;
859 wxGridRowLabelWindow
*m_rowLabelWin
;
860 wxGridColLabelWindow
*m_colLabelWin
;
861 wxGridCornerLabelWindow
*m_cornerLabelWin
;
863 wxBoxSizer
*m_mainSizer
;
864 wxBoxSizer
*m_topSizer
;
865 wxBoxSizer
*m_middleSizer
;
867 wxGridTableBase
*m_table
;
877 wxGridCellCoords m_currentCellCoords
;
879 wxGridCellCoords m_selectedTopLeft
;
880 wxGridCellCoords m_selectedBottomRight
;
882 int m_defaultRowHeight
;
883 wxArrayInt m_rowHeights
;
884 wxArrayInt m_rowBottoms
;
886 int m_defaultColWidth
;
887 wxArrayInt m_colWidths
;
888 wxArrayInt m_colRights
;
891 int m_colLabelHeight
;
893 wxColour m_labelBackgroundColour
;
894 wxColour m_labelTextColour
;
897 int m_rowLabelHorizAlign
;
898 int m_rowLabelVertAlign
;
899 int m_colLabelHorizAlign
;
900 int m_colLabelVertAlign
;
902 bool m_defaultRowLabelValues
;
903 bool m_defaultColLabelValues
;
905 wxColour m_gridLineColour
;
906 bool m_gridLinesEnabled
;
908 wxFont m_defaultCellFont
;
910 wxGridCellCoordsArray m_cellsExposed
;
911 wxArrayInt m_rowsExposed
;
912 wxArrayInt m_colsExposed
;
913 wxArrayInt m_rowLabelsExposed
;
914 wxArrayInt m_colLabelsExposed
;
920 enum { WXGRID_CURSOR_DEFAULT
,
921 WXGRID_CURSOR_SELECT_CELL
,
922 WXGRID_CURSOR_RESIZE_ROW
,
923 WXGRID_CURSOR_RESIZE_COL
,
924 WXGRID_CURSOR_SELECT_ROW
,
925 WXGRID_CURSOR_SELECT_COL
932 wxGridCellCoords m_selectionStart
;
934 wxCursor m_rowResizeCursor
;
935 wxCursor m_colResizeCursor
;
937 bool m_editable
; // applies to whole grid
938 int m_editCtrlType
; // for current cell
939 wxWindow
* m_cellEditCtrl
;
940 bool m_cellEditCtrlEnabled
;
945 void CalcDimensions();
946 bool Redimension( wxGridTableMessage
& );
949 bool SendEvent( const wxEventType
,
953 bool SendEvent( const wxEventType
,
957 void OnPaint( wxPaintEvent
& );
958 void OnSize( wxSizeEvent
& );
959 void OnKeyDown( wxKeyEvent
& );
962 void SetCurrentCell( const wxGridCellCoords
& coords
);
963 void SetCurrentCell( int row
, int col
)
964 { SetCurrentCell( wxGridCellCoords(row
, col
) ); }
967 // ------ functions to get/send data (see also public functions)
969 bool GetModelValues();
970 bool SetModelValues();
973 DECLARE_DYNAMIC_CLASS( wxGrid
)
974 DECLARE_EVENT_TABLE()
982 // ------ Grid event class and event types
985 class WXDLLEXPORT wxGridEvent
: public wxNotifyEvent
989 : wxNotifyEvent(), m_row(-1), m_col(-1), m_x(-1), m_y(-1),
990 m_control(0), m_meta(0), m_shift(0), m_alt(0)
994 wxGridEvent(int id
, wxEventType type
, wxObject
* obj
,
995 int row
=-1, int col
=-1, int x
=-1, int y
=-1,
996 bool control
=FALSE
, bool shift
=FALSE
, bool alt
=FALSE
, bool meta
=FALSE
);
998 virtual int GetRow() { return m_row
; }
999 virtual int GetCol() { return m_col
; }
1000 wxPoint
GetPosition() { return wxPoint( m_x
, m_y
); }
1001 bool ControlDown() { return m_control
; }
1002 bool MetaDown() { return m_meta
; }
1003 bool ShiftDown() { return m_shift
; }
1004 bool AltDown() { return m_alt
; }
1016 DECLARE_DYNAMIC_CLASS(wxGridEvent
)
1020 class WXDLLEXPORT wxGridSizeEvent
: public wxNotifyEvent
1024 : wxNotifyEvent(), m_rowOrCol(-1), m_x(-1), m_y(-1),
1025 m_control(0), m_meta(0), m_shift(0), m_alt(0)
1029 wxGridSizeEvent(int id
, wxEventType type
, wxObject
* obj
,
1030 int rowOrCol
=-1, int x
=-1, int y
=-1,
1031 bool control
=FALSE
, bool shift
=FALSE
, bool alt
=FALSE
, bool meta
=FALSE
);
1033 int GetRowOrCol() { return m_rowOrCol
; }
1034 wxPoint
GetPosition() { return wxPoint( m_x
, m_y
); }
1035 bool ControlDown() { return m_control
; }
1036 bool MetaDown() { return m_meta
; }
1037 bool ShiftDown() { return m_shift
; }
1038 bool AltDown() { return m_alt
; }
1049 DECLARE_DYNAMIC_CLASS(wxGridSizeEvent
)
1053 class WXDLLEXPORT wxGridRangeSelectEvent
: public wxNotifyEvent
1056 wxGridRangeSelectEvent()
1059 m_topLeft
= wxGridNoCellCoords
;
1060 m_bottomRight
= wxGridNoCellCoords
;
1067 wxGridRangeSelectEvent(int id
, wxEventType type
, wxObject
* obj
,
1068 const wxGridCellCoords
& topLeft
,
1069 const wxGridCellCoords
& bottomRight
,
1070 bool control
=FALSE
, bool shift
=FALSE
,
1071 bool alt
=FALSE
, bool meta
=FALSE
);
1073 wxGridCellCoords
GetTopLeftCoords() { return m_topLeft
; }
1074 wxGridCellCoords
GetBottomRightCoords() { return m_bottomRight
; }
1075 int GetTopRow() { return m_topLeft
.GetRow(); }
1076 int GetBottomRow() { return m_bottomRight
.GetRow(); }
1077 int GetLeftCol() { return m_topLeft
.GetCol(); }
1078 int GetRightCol() { return m_bottomRight
.GetCol(); }
1079 bool ControlDown() { return m_control
; }
1080 bool MetaDown() { return m_meta
; }
1081 bool ShiftDown() { return m_shift
; }
1082 bool AltDown() { return m_alt
; }
1085 wxGridCellCoords m_topLeft
;
1086 wxGridCellCoords m_bottomRight
;
1092 DECLARE_DYNAMIC_CLASS(wxGridRangeSelectEvent
)
1096 const wxEventType EVT_GRID_CELL_LEFT_CLICK
= wxEVT_FIRST
+ 1580;
1097 const wxEventType EVT_GRID_CELL_RIGHT_CLICK
= wxEVT_FIRST
+ 1581;
1098 const wxEventType EVT_GRID_CELL_LEFT_DCLICK
= wxEVT_FIRST
+ 1582;
1099 const wxEventType EVT_GRID_CELL_RIGHT_DCLICK
= wxEVT_FIRST
+ 1583;
1100 const wxEventType EVT_GRID_LABEL_LEFT_CLICK
= wxEVT_FIRST
+ 1584;
1101 const wxEventType EVT_GRID_LABEL_RIGHT_CLICK
= wxEVT_FIRST
+ 1585;
1102 const wxEventType EVT_GRID_LABEL_LEFT_DCLICK
= wxEVT_FIRST
+ 1586;
1103 const wxEventType EVT_GRID_LABEL_RIGHT_DCLICK
= wxEVT_FIRST
+ 1587;
1104 const wxEventType EVT_GRID_ROW_SIZE
= wxEVT_FIRST
+ 1588;
1105 const wxEventType EVT_GRID_COL_SIZE
= wxEVT_FIRST
+ 1589;
1106 const wxEventType EVT_GRID_RANGE_SELECT
= wxEVT_FIRST
+ 1590;
1107 const wxEventType EVT_GRID_CELL_CHANGE
= wxEVT_FIRST
+ 1591;
1108 const wxEventType EVT_GRID_SELECT_CELL
= wxEVT_FIRST
+ 1592;
1111 typedef void (wxEvtHandler::*wxGridEventFunction
)(wxGridEvent
&);
1112 typedef void (wxEvtHandler::*wxGridSizeEventFunction
)(wxGridSizeEvent
&);
1113 typedef void (wxEvtHandler::*wxGridRangeSelectEventFunction
)(wxGridRangeSelectEvent
&);
1115 #define EVT_GRID_CELL_LEFT_CLICK(fn) { EVT_GRID_CELL_LEFT_CLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1116 #define EVT_GRID_CELL_RIGHT_CLICK(fn) { EVT_GRID_CELL_RIGHT_CLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1117 #define EVT_GRID_CELL_LEFT_DCLICK(fn) { EVT_GRID_CELL_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1118 #define EVT_GRID_CELL_RIGHT_DCLICK(fn) { EVT_GRID_CELL_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1119 #define EVT_GRID_LABEL_LEFT_CLICK(fn) { EVT_GRID_LABEL_LEFT_CLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1120 #define EVT_GRID_LABEL_RIGHT_CLICK(fn) { EVT_GRID_LABEL_RIGHT_CLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1121 #define EVT_GRID_LABEL_LEFT_DCLICK(fn) { EVT_GRID_LABEL_LEFT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1122 #define EVT_GRID_LABEL_RIGHT_DCLICK(fn) { EVT_GRID_LABEL_RIGHT_DCLICK, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1123 #define EVT_GRID_ROW_SIZE(fn) { EVT_GRID_ROW_SIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridSizeEventFunction) &fn, NULL },
1124 #define EVT_GRID_COL_SIZE(fn) { EVT_GRID_COL_SIZE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridSizeEventFunction) &fn, NULL },
1125 #define EVT_GRID_RANGE_SELECT(fn) { EVT_GRID_RANGE_SELECT, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridRangeSelectEventFunction) &fn, NULL },
1126 #define EVT_GRID_CELL_CHANGE(fn) { EVT_GRID_CELL_CHANGE, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1127 #define EVT_GRID_SELECT_CELL(fn) { EVT_GRID_SELECT_CELL, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1130 #if 0 // TODO: implement these ? others ?
1132 const wxEventType EVT_GRID_CREATE_CELL
= wxEVT_FIRST
+ 1576;
1133 const wxEventType EVT_GRID_CHANGE_LABELS
= wxEVT_FIRST
+ 1577;
1134 const wxEventType EVT_GRID_CHANGE_SEL_LABEL
= wxEVT_FIRST
+ 1578;
1136 #define EVT_GRID_CREATE_CELL(fn) { EVT_GRID_CREATE_CELL, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1137 #define EVT_GRID_CHANGE_LABELS(fn) { EVT_GRID_CHANGE_LABELS, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1138 #define EVT_GRID_CHANGE_SEL_LABEL(fn) { EVT_GRID_CHANGE_SEL_LABEL, -1, -1, (wxObjectEventFunction) (wxEventFunction) (wxGridEventFunction) &fn, NULL },
1142 #endif // #ifndef __WXGRID_H__
1144 #endif // ifndef wxUSE_NEW_GRID