1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/generic/private/grid.h
3 // Purpose: Private wxGrid structures
4 // Author: Michael Bedward (based on code by Julian Smart, Robin Dunn)
5 // Modified by: Santiago Palacios
8 // Copyright: (c) Michael Bedward
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_GENERIC_GRID_PRIVATE_H_
13 #define _WX_GENERIC_GRID_PRIVATE_H_
19 // ----------------------------------------------------------------------------
21 // ----------------------------------------------------------------------------
23 WX_DEFINE_ARRAY_WITH_DECL_PTR(wxGridCellAttr
*, wxArrayAttrs
,
24 class WXDLLIMPEXP_ADV
);
26 struct wxGridCellWithAttr
28 wxGridCellWithAttr(int row
, int col
, wxGridCellAttr
*attr_
)
29 : coords(row
, col
), attr(attr_
)
34 wxGridCellWithAttr(const wxGridCellWithAttr
& other
)
35 : coords(other
.coords
),
41 wxGridCellWithAttr
& operator=(const wxGridCellWithAttr
& other
)
43 coords
= other
.coords
;
44 if (attr
!= other
.attr
)
53 void ChangeAttr(wxGridCellAttr
* new_attr
)
57 // "Delete" (i.e. DecRef) the old attribute.
60 // Take ownership of the new attribute, i.e. no IncRef.
69 wxGridCellCoords coords
;
73 WX_DECLARE_OBJARRAY_WITH_DECL(wxGridCellWithAttr
, wxGridCellWithAttrArray
,
74 class WXDLLIMPEXP_ADV
);
77 // ----------------------------------------------------------------------------
79 // ----------------------------------------------------------------------------
81 // header column providing access to the column information stored in wxGrid
82 // via wxHeaderColumn interface
83 class wxGridHeaderColumn
: public wxHeaderColumn
86 wxGridHeaderColumn(wxGrid
*grid
, int col
)
92 virtual wxString
GetTitle() const { return m_grid
->GetColLabelValue(m_col
); }
93 virtual wxBitmap
GetBitmap() const { return wxNullBitmap
; }
94 virtual int GetWidth() const { return m_grid
->GetColSize(m_col
); }
95 virtual int GetMinWidth() const { return 0; }
96 virtual wxAlignment
GetAlignment() const
100 m_grid
->GetColLabelAlignment(&horz
, &vert
);
102 return static_cast<wxAlignment
>(horz
);
105 virtual int GetFlags() const
107 // we can't know in advance whether we can sort by this column or not
108 // with wxGrid API so suppose we can by default
109 int flags
= wxCOL_SORTABLE
;
110 if ( m_grid
->CanDragColSize(m_col
) )
111 flags
|= wxCOL_RESIZABLE
;
112 if ( m_grid
->CanDragColMove() )
113 flags
|= wxCOL_REORDERABLE
;
114 if ( GetWidth() == 0 )
115 flags
|= wxCOL_HIDDEN
;
120 virtual bool IsSortKey() const
122 return m_grid
->IsSortingBy(m_col
);
125 virtual bool IsSortOrderAscending() const
127 return m_grid
->IsSortOrderAscending();
131 // these really should be const but are not because the column needs to be
132 // assignable to be used in a wxVector (in STL build, in non-STL build we
133 // avoid the need for this)
138 // header control retreiving column information from the grid
139 class wxGridHeaderCtrl
: public wxHeaderCtrl
142 wxGridHeaderCtrl(wxGrid
*owner
)
143 : wxHeaderCtrl(owner
,
148 (owner
->CanDragColMove() ? wxHD_ALLOW_REORDER
: 0))
153 virtual const wxHeaderColumn
& GetColumn(unsigned int idx
) const
155 return m_columns
[idx
];
159 wxGrid
*GetOwner() const { return static_cast<wxGrid
*>(GetParent()); }
161 static wxMouseEvent
GetDummyMouseEvent()
163 // make up a dummy event for the grid event to use -- unfortunately we
164 // can't do anything else here
166 e
.SetState(wxGetMouseState());
170 // override the base class method to update our m_columns array
171 virtual void OnColumnCountChanging(unsigned int count
)
173 const unsigned countOld
= m_columns
.size();
174 if ( count
< countOld
)
176 // just discard the columns which don't exist any more (notice that
177 // we can't use resize() here as it would require the vector
178 // value_type, i.e. wxGridHeaderColumn to be default constructible,
180 m_columns
.erase(m_columns
.begin() + count
, m_columns
.end());
182 else // new columns added
184 // add columns for the new elements
185 for ( unsigned n
= countOld
; n
< count
; n
++ )
186 m_columns
.push_back(wxGridHeaderColumn(GetOwner(), n
));
190 // override to implement column auto sizing
191 virtual bool UpdateColumnWidthToFit(unsigned int idx
, int widthTitle
)
193 // TODO: currently grid doesn't support computing the column best width
194 // from its contents so we just use the best label width as is
195 GetOwner()->SetColSize(idx
, widthTitle
);
200 // overridden to react to the actions using the columns popup menu
201 virtual void UpdateColumnVisibility(unsigned int idx
, bool show
)
203 GetOwner()->SetColSize(idx
, show
? wxGRID_AUTOSIZE
: 0);
205 // as this is done by the user we should notify the main program about
207 GetOwner()->SendGridSizeEvent(wxEVT_GRID_COL_SIZE
, -1, idx
,
208 GetDummyMouseEvent());
211 // overridden to react to the columns order changes in the customization
213 virtual void UpdateColumnsOrder(const wxArrayInt
& order
)
215 GetOwner()->SetColumnsOrder(order
);
219 // event handlers forwarding wxHeaderCtrl events to wxGrid
220 void OnClick(wxHeaderCtrlEvent
& event
)
222 GetOwner()->SendEvent(wxEVT_GRID_LABEL_LEFT_CLICK
,
223 -1, event
.GetColumn(),
224 GetDummyMouseEvent());
226 GetOwner()->DoColHeaderClick(event
.GetColumn());
229 void OnDoubleClick(wxHeaderCtrlEvent
& event
)
231 if ( !GetOwner()->SendEvent(wxEVT_GRID_LABEL_LEFT_DCLICK
,
232 -1, event
.GetColumn(),
233 GetDummyMouseEvent()) )
239 void OnRightClick(wxHeaderCtrlEvent
& event
)
241 if ( !GetOwner()->SendEvent(wxEVT_GRID_LABEL_RIGHT_CLICK
,
242 -1, event
.GetColumn(),
243 GetDummyMouseEvent()) )
249 void OnBeginResize(wxHeaderCtrlEvent
& event
)
251 GetOwner()->DoStartResizeCol(event
.GetColumn());
256 void OnResizing(wxHeaderCtrlEvent
& event
)
258 GetOwner()->DoUpdateResizeColWidth(event
.GetWidth());
261 void OnEndResize(wxHeaderCtrlEvent
& event
)
263 // we again need to pass a mouse event to be used for the grid event
264 // generation but we don't have it here so use a dummy one as in
265 // UpdateColumnVisibility()
267 e
.SetState(wxGetMouseState());
268 GetOwner()->DoEndDragResizeCol(e
);
273 void OnBeginReorder(wxHeaderCtrlEvent
& event
)
275 GetOwner()->DoStartMoveCol(event
.GetColumn());
278 void OnEndReorder(wxHeaderCtrlEvent
& event
)
280 GetOwner()->DoEndMoveCol(event
.GetNewOrder());
283 wxVector
<wxGridHeaderColumn
> m_columns
;
285 DECLARE_EVENT_TABLE()
286 wxDECLARE_NO_COPY_CLASS(wxGridHeaderCtrl
);
289 // common base class for various grid subwindows
290 class WXDLLIMPEXP_ADV wxGridSubwindow
: public wxWindow
293 wxGridSubwindow(wxGrid
*owner
,
294 int additionalStyle
= 0,
295 const wxString
& name
= wxPanelNameStr
)
296 : wxWindow(owner
, wxID_ANY
,
297 wxDefaultPosition
, wxDefaultSize
,
298 wxBORDER_NONE
| additionalStyle
,
304 virtual wxWindow
*GetMainWindowOfCompositeControl() { return m_owner
; }
306 virtual bool AcceptsFocus() const { return false; }
308 wxGrid
*GetOwner() { return m_owner
; }
311 void OnMouseCaptureLost(wxMouseCaptureLostEvent
& event
);
315 DECLARE_EVENT_TABLE()
316 wxDECLARE_NO_COPY_CLASS(wxGridSubwindow
);
319 class WXDLLIMPEXP_ADV wxGridRowLabelWindow
: public wxGridSubwindow
322 wxGridRowLabelWindow(wxGrid
*parent
)
323 : wxGridSubwindow(parent
)
329 void OnPaint( wxPaintEvent
& event
);
330 void OnMouseEvent( wxMouseEvent
& event
);
331 void OnMouseWheel( wxMouseEvent
& event
);
333 DECLARE_EVENT_TABLE()
334 wxDECLARE_NO_COPY_CLASS(wxGridRowLabelWindow
);
338 class WXDLLIMPEXP_ADV wxGridColLabelWindow
: public wxGridSubwindow
341 wxGridColLabelWindow(wxGrid
*parent
)
342 : wxGridSubwindow(parent
)
348 void OnPaint( wxPaintEvent
& event
);
349 void OnMouseEvent( wxMouseEvent
& event
);
350 void OnMouseWheel( wxMouseEvent
& event
);
352 DECLARE_EVENT_TABLE()
353 wxDECLARE_NO_COPY_CLASS(wxGridColLabelWindow
);
357 class WXDLLIMPEXP_ADV wxGridCornerLabelWindow
: public wxGridSubwindow
360 wxGridCornerLabelWindow(wxGrid
*parent
)
361 : wxGridSubwindow(parent
)
366 void OnMouseEvent( wxMouseEvent
& event
);
367 void OnMouseWheel( wxMouseEvent
& event
);
368 void OnPaint( wxPaintEvent
& event
);
370 DECLARE_EVENT_TABLE()
371 wxDECLARE_NO_COPY_CLASS(wxGridCornerLabelWindow
);
374 class WXDLLIMPEXP_ADV wxGridWindow
: public wxGridSubwindow
377 wxGridWindow(wxGrid
*parent
)
378 : wxGridSubwindow(parent
,
379 wxWANTS_CHARS
| wxCLIP_CHILDREN
,
385 virtual void ScrollWindow( int dx
, int dy
, const wxRect
*rect
);
387 virtual bool AcceptsFocus() const { return true; }
390 void OnPaint( wxPaintEvent
&event
);
391 void OnMouseWheel( wxMouseEvent
& event
);
392 void OnMouseEvent( wxMouseEvent
& event
);
393 void OnKeyDown( wxKeyEvent
& );
394 void OnKeyUp( wxKeyEvent
& );
395 void OnChar( wxKeyEvent
& );
396 void OnEraseBackground( wxEraseEvent
& );
397 void OnFocus( wxFocusEvent
& );
399 DECLARE_EVENT_TABLE()
400 wxDECLARE_NO_COPY_CLASS(wxGridWindow
);
403 // ----------------------------------------------------------------------------
404 // the internal data representation used by wxGridCellAttrProvider
405 // ----------------------------------------------------------------------------
407 // this class stores attributes set for cells
408 class WXDLLIMPEXP_ADV wxGridCellAttrData
411 void SetAttr(wxGridCellAttr
*attr
, int row
, int col
);
412 wxGridCellAttr
*GetAttr(int row
, int col
) const;
413 void UpdateAttrRows( size_t pos
, int numRows
);
414 void UpdateAttrCols( size_t pos
, int numCols
);
417 // searches for the attr for given cell, returns wxNOT_FOUND if not found
418 int FindIndex(int row
, int col
) const;
420 wxGridCellWithAttrArray m_attrs
;
423 // this class stores attributes set for rows or columns
424 class WXDLLIMPEXP_ADV wxGridRowOrColAttrData
427 // empty ctor to suppress warnings
428 wxGridRowOrColAttrData() {}
429 ~wxGridRowOrColAttrData();
431 void SetAttr(wxGridCellAttr
*attr
, int rowOrCol
);
432 wxGridCellAttr
*GetAttr(int rowOrCol
) const;
433 void UpdateAttrRowsOrCols( size_t pos
, int numRowsOrCols
);
436 wxArrayInt m_rowsOrCols
;
437 wxArrayAttrs m_attrs
;
440 // NB: this is just a wrapper around 3 objects: one which stores cell
441 // attributes, and 2 others for row/col ones
442 class WXDLLIMPEXP_ADV wxGridCellAttrProviderData
445 wxGridCellAttrData m_cellAttrs
;
446 wxGridRowOrColAttrData m_rowAttrs
,
450 // ----------------------------------------------------------------------------
451 // operations classes abstracting the difference between operating on rows and
453 // ----------------------------------------------------------------------------
455 // This class allows to write a function only once because by using its methods
456 // it will apply to both columns and rows.
458 // This is an abstract interface definition, the two concrete implementations
459 // below should be used when working with rows and columns respectively.
460 class wxGridOperations
463 // Returns the operations in the other direction, i.e. wxGridRowOperations
464 // if this object is a wxGridColumnOperations and vice versa.
465 virtual wxGridOperations
& Dual() const = 0;
467 // Return the number of rows or columns.
468 virtual int GetNumberOfLines(const wxGrid
*grid
) const = 0;
470 // Return the selection mode which allows selecting rows or columns.
471 virtual wxGrid::wxGridSelectionModes
GetSelectionMode() const = 0;
473 // Make a wxGridCellCoords from the given components: thisDir is row or
474 // column and otherDir is column or row
475 virtual wxGridCellCoords
MakeCoords(int thisDir
, int otherDir
) const = 0;
477 // Calculate the scrolled position of the given abscissa or ordinate.
478 virtual int CalcScrolledPosition(wxGrid
*grid
, int pos
) const = 0;
480 // Selects the horizontal or vertical component from the given object.
481 virtual int Select(const wxGridCellCoords
& coords
) const = 0;
482 virtual int Select(const wxPoint
& pt
) const = 0;
483 virtual int Select(const wxSize
& sz
) const = 0;
484 virtual int Select(const wxRect
& r
) const = 0;
485 virtual int& Select(wxRect
& r
) const = 0;
487 // Returns width or height of the rectangle
488 virtual int& SelectSize(wxRect
& r
) const = 0;
490 // Make a wxSize such that Select() applied to it returns first component
491 virtual wxSize
MakeSize(int first
, int second
) const = 0;
493 // Sets the row or column component of the given cell coordinates
494 virtual void Set(wxGridCellCoords
& coords
, int line
) const = 0;
497 // Draws a line parallel to the row or column, i.e. horizontal or vertical:
498 // pos is the horizontal or vertical position of the line and start and end
499 // are the coordinates of the line extremities in the other direction
501 DrawParallelLine(wxDC
& dc
, int start
, int end
, int pos
) const = 0;
503 // Draw a horizontal or vertical line across the given rectangle
504 // (this is implemented in terms of above and uses Select() to extract
505 // start and end from the given rectangle)
506 void DrawParallelLineInRect(wxDC
& dc
, const wxRect
& rect
, int pos
) const
508 const int posStart
= Select(rect
.GetPosition());
509 DrawParallelLine(dc
, posStart
, posStart
+ Select(rect
.GetSize()), pos
);
513 // Return the index of the row or column at the given pixel coordinate.
515 PosToLine(const wxGrid
*grid
, int pos
, bool clip
= false) const = 0;
517 // Get the top/left position, in pixels, of the given row or column
518 virtual int GetLineStartPos(const wxGrid
*grid
, int line
) const = 0;
520 // Get the bottom/right position, in pixels, of the given row or column
521 virtual int GetLineEndPos(const wxGrid
*grid
, int line
) const = 0;
523 // Get the height/width of the given row/column
524 virtual int GetLineSize(const wxGrid
*grid
, int line
) const = 0;
526 // Get wxGrid::m_rowBottoms/m_colRights array
527 virtual const wxArrayInt
& GetLineEnds(const wxGrid
*grid
) const = 0;
529 // Get default height row height or column width
530 virtual int GetDefaultLineSize(const wxGrid
*grid
) const = 0;
532 // Return the minimal acceptable row height or column width
533 virtual int GetMinimalAcceptableLineSize(const wxGrid
*grid
) const = 0;
535 // Return the minimal row height or column width
536 virtual int GetMinimalLineSize(const wxGrid
*grid
, int line
) const = 0;
538 // Set the row height or column width
539 virtual void SetLineSize(wxGrid
*grid
, int line
, int size
) const = 0;
541 // Set the row default height or column default width
542 virtual void SetDefaultLineSize(wxGrid
*grid
, int size
, bool resizeExisting
) const = 0;
545 // Return the index of the line at the given position
547 // NB: currently this is always identity for the rows as reordering is only
548 // implemented for the lines
549 virtual int GetLineAt(const wxGrid
*grid
, int pos
) const = 0;
551 // Return the display position of the line with the given index.
553 // NB: As GetLineAt(), currently this is always identity for rows.
554 virtual int GetLinePos(const wxGrid
*grid
, int line
) const = 0;
556 // Return the index of the line just before the given one or wxNOT_FOUND.
557 virtual int GetLineBefore(const wxGrid
* grid
, int line
) const = 0;
559 // Get the row or column label window
560 virtual wxWindow
*GetHeaderWindow(wxGrid
*grid
) const = 0;
562 // Get the width or height of the row or column label window
563 virtual int GetHeaderWindowSize(wxGrid
*grid
) const = 0;
566 // This class is never used polymorphically but give it a virtual dtor
567 // anyhow to suppress g++ complaints about it
568 virtual ~wxGridOperations() { }
571 class wxGridRowOperations
: public wxGridOperations
574 virtual wxGridOperations
& Dual() const;
576 virtual int GetNumberOfLines(const wxGrid
*grid
) const
577 { return grid
->GetNumberRows(); }
579 virtual wxGrid::wxGridSelectionModes
GetSelectionMode() const
580 { return wxGrid::wxGridSelectRows
; }
582 virtual wxGridCellCoords
MakeCoords(int thisDir
, int otherDir
) const
583 { return wxGridCellCoords(thisDir
, otherDir
); }
585 virtual int CalcScrolledPosition(wxGrid
*grid
, int pos
) const
586 { return grid
->CalcScrolledPosition(wxPoint(pos
, 0)).x
; }
588 virtual int Select(const wxGridCellCoords
& c
) const { return c
.GetRow(); }
589 virtual int Select(const wxPoint
& pt
) const { return pt
.x
; }
590 virtual int Select(const wxSize
& sz
) const { return sz
.x
; }
591 virtual int Select(const wxRect
& r
) const { return r
.x
; }
592 virtual int& Select(wxRect
& r
) const { return r
.x
; }
593 virtual int& SelectSize(wxRect
& r
) const { return r
.width
; }
594 virtual wxSize
MakeSize(int first
, int second
) const
595 { return wxSize(first
, second
); }
596 virtual void Set(wxGridCellCoords
& coords
, int line
) const
597 { coords
.SetRow(line
); }
599 virtual void DrawParallelLine(wxDC
& dc
, int start
, int end
, int pos
) const
600 { dc
.DrawLine(start
, pos
, end
, pos
); }
602 virtual int PosToLine(const wxGrid
*grid
, int pos
, bool clip
= false) const
603 { return grid
->YToRow(pos
, clip
); }
604 virtual int GetLineStartPos(const wxGrid
*grid
, int line
) const
605 { return grid
->GetRowTop(line
); }
606 virtual int GetLineEndPos(const wxGrid
*grid
, int line
) const
607 { return grid
->GetRowBottom(line
); }
608 virtual int GetLineSize(const wxGrid
*grid
, int line
) const
609 { return grid
->GetRowHeight(line
); }
610 virtual const wxArrayInt
& GetLineEnds(const wxGrid
*grid
) const
611 { return grid
->m_rowBottoms
; }
612 virtual int GetDefaultLineSize(const wxGrid
*grid
) const
613 { return grid
->GetDefaultRowSize(); }
614 virtual int GetMinimalAcceptableLineSize(const wxGrid
*grid
) const
615 { return grid
->GetRowMinimalAcceptableHeight(); }
616 virtual int GetMinimalLineSize(const wxGrid
*grid
, int line
) const
617 { return grid
->GetRowMinimalHeight(line
); }
618 virtual void SetLineSize(wxGrid
*grid
, int line
, int size
) const
619 { grid
->SetRowSize(line
, size
); }
620 virtual void SetDefaultLineSize(wxGrid
*grid
, int size
, bool resizeExisting
) const
621 { grid
->SetDefaultRowSize(size
, resizeExisting
); }
623 virtual int GetLineAt(const wxGrid
* WXUNUSED(grid
), int pos
) const
624 { return pos
; } // TODO: implement row reordering
625 virtual int GetLinePos(const wxGrid
* WXUNUSED(grid
), int line
) const
626 { return line
; } // TODO: implement row reordering
628 virtual int GetLineBefore(const wxGrid
* WXUNUSED(grid
), int line
) const
631 virtual wxWindow
*GetHeaderWindow(wxGrid
*grid
) const
632 { return grid
->GetGridRowLabelWindow(); }
633 virtual int GetHeaderWindowSize(wxGrid
*grid
) const
634 { return grid
->GetRowLabelSize(); }
637 class wxGridColumnOperations
: public wxGridOperations
640 virtual wxGridOperations
& Dual() const;
642 virtual int GetNumberOfLines(const wxGrid
*grid
) const
643 { return grid
->GetNumberCols(); }
645 virtual wxGrid::wxGridSelectionModes
GetSelectionMode() const
646 { return wxGrid::wxGridSelectColumns
; }
648 virtual wxGridCellCoords
MakeCoords(int thisDir
, int otherDir
) const
649 { return wxGridCellCoords(otherDir
, thisDir
); }
651 virtual int CalcScrolledPosition(wxGrid
*grid
, int pos
) const
652 { return grid
->CalcScrolledPosition(wxPoint(0, pos
)).y
; }
654 virtual int Select(const wxGridCellCoords
& c
) const { return c
.GetCol(); }
655 virtual int Select(const wxPoint
& pt
) const { return pt
.y
; }
656 virtual int Select(const wxSize
& sz
) const { return sz
.y
; }
657 virtual int Select(const wxRect
& r
) const { return r
.y
; }
658 virtual int& Select(wxRect
& r
) const { return r
.y
; }
659 virtual int& SelectSize(wxRect
& r
) const { return r
.height
; }
660 virtual wxSize
MakeSize(int first
, int second
) const
661 { return wxSize(second
, first
); }
662 virtual void Set(wxGridCellCoords
& coords
, int line
) const
663 { coords
.SetCol(line
); }
665 virtual void DrawParallelLine(wxDC
& dc
, int start
, int end
, int pos
) const
666 { dc
.DrawLine(pos
, start
, pos
, end
); }
668 virtual int PosToLine(const wxGrid
*grid
, int pos
, bool clip
= false) const
669 { return grid
->XToCol(pos
, clip
); }
670 virtual int GetLineStartPos(const wxGrid
*grid
, int line
) const
671 { return grid
->GetColLeft(line
); }
672 virtual int GetLineEndPos(const wxGrid
*grid
, int line
) const
673 { return grid
->GetColRight(line
); }
674 virtual int GetLineSize(const wxGrid
*grid
, int line
) const
675 { return grid
->GetColWidth(line
); }
676 virtual const wxArrayInt
& GetLineEnds(const wxGrid
*grid
) const
677 { return grid
->m_colRights
; }
678 virtual int GetDefaultLineSize(const wxGrid
*grid
) const
679 { return grid
->GetDefaultColSize(); }
680 virtual int GetMinimalAcceptableLineSize(const wxGrid
*grid
) const
681 { return grid
->GetColMinimalAcceptableWidth(); }
682 virtual int GetMinimalLineSize(const wxGrid
*grid
, int line
) const
683 { return grid
->GetColMinimalWidth(line
); }
684 virtual void SetLineSize(wxGrid
*grid
, int line
, int size
) const
685 { grid
->SetColSize(line
, size
); }
686 virtual void SetDefaultLineSize(wxGrid
*grid
, int size
, bool resizeExisting
) const
687 { grid
->SetDefaultColSize(size
, resizeExisting
); }
689 virtual int GetLineAt(const wxGrid
*grid
, int pos
) const
690 { return grid
->GetColAt(pos
); }
691 virtual int GetLinePos(const wxGrid
*grid
, int line
) const
692 { return grid
->GetColPos(line
); }
694 virtual int GetLineBefore(const wxGrid
* grid
, int line
) const
696 int posBefore
= grid
->GetColPos(line
) - 1;
697 return posBefore
>= 0 ? grid
->GetColAt(posBefore
) : wxNOT_FOUND
;
700 virtual wxWindow
*GetHeaderWindow(wxGrid
*grid
) const
701 { return grid
->GetGridColLabelWindow(); }
702 virtual int GetHeaderWindowSize(wxGrid
*grid
) const
703 { return grid
->GetColLabelSize(); }
706 // This class abstracts the difference between operations going forward
707 // (down/right) and backward (up/left) and allows to use the same code for
708 // functions which differ only in the direction of grid traversal.
710 // Notice that all operations in this class work with display positions and not
711 // internal indices which can be different if the columns were reordered.
713 // Like wxGridOperations it's an ABC with two concrete subclasses below. Unlike
714 // it, this is a normal object and not just a function dispatch table and has a
717 // Note: the explanation of this discrepancy is the existence of (very useful)
718 // Dual() method in wxGridOperations which forces us to make wxGridOperations a
719 // function dispatcher only.
720 class wxGridDirectionOperations
723 // The oper parameter to ctor selects whether we work with rows or columns
724 wxGridDirectionOperations(wxGrid
*grid
, const wxGridOperations
& oper
)
730 // Check if the component of this point in our direction is at the
731 // boundary, i.e. is the first/last row/column
732 virtual bool IsAtBoundary(const wxGridCellCoords
& coords
) const = 0;
734 // Increment the component of this point in our direction
735 virtual void Advance(wxGridCellCoords
& coords
) const = 0;
737 // Find the line at the given distance, in pixels, away from this one
738 // (this uses clipping, i.e. anything after the last line is counted as the
739 // last one and anything before the first one as 0)
741 // TODO: Implementation of this method currently doesn't support column
742 // reordering as it mixes up indices and positions. But this doesn't
743 // really matter as it's only called for rows (Page Up/Down only work
744 // vertically) and row reordering is not currently supported. We'd
745 // need to fix it if this ever changes however.
746 virtual int MoveByPixelDistance(int line
, int distance
) const = 0;
748 // This class is never used polymorphically but give it a virtual dtor
749 // anyhow to suppress g++ complaints about it
750 virtual ~wxGridDirectionOperations() { }
753 // Get the position of the row or column from the given coordinates pair.
755 // This is just a shortcut to avoid repeating m_oper and m_grid multiple
756 // times in the derived classes code.
757 int GetLinePos(const wxGridCellCoords
& coords
) const
759 return m_oper
.GetLinePos(m_grid
, m_oper
.Select(coords
));
762 // Get the index of the row or column from the position.
763 int GetLineAt(int pos
) const
765 return m_oper
.GetLineAt(m_grid
, pos
);
768 // Check if the given line is visible, i.e. has non 0 size.
769 bool IsLineVisible(int line
) const
771 return m_oper
.GetLineSize(m_grid
, line
) != 0;
775 wxGrid
* const m_grid
;
776 const wxGridOperations
& m_oper
;
779 class wxGridBackwardOperations
: public wxGridDirectionOperations
782 wxGridBackwardOperations(wxGrid
*grid
, const wxGridOperations
& oper
)
783 : wxGridDirectionOperations(grid
, oper
)
787 virtual bool IsAtBoundary(const wxGridCellCoords
& coords
) const
789 wxASSERT_MSG( m_oper
.Select(coords
) >= 0, "invalid row/column" );
791 int pos
= GetLinePos(coords
);
794 // Check the previous line.
795 int line
= GetLineAt(--pos
);
796 if ( IsLineVisible(line
) )
798 // There is another visible line before this one, hence it's
804 // We reached the boundary without finding any visible lines.
808 virtual void Advance(wxGridCellCoords
& coords
) const
810 int pos
= GetLinePos(coords
);
813 // This is not supposed to happen if IsAtBoundary() returned false.
814 wxCHECK_RET( pos
, "can't advance when already at boundary" );
816 int line
= GetLineAt(--pos
);
817 if ( IsLineVisible(line
) )
819 m_oper
.Set(coords
, line
);
825 virtual int MoveByPixelDistance(int line
, int distance
) const
827 int pos
= m_oper
.GetLineStartPos(m_grid
, line
);
828 return m_oper
.PosToLine(m_grid
, pos
- distance
+ 1, true);
832 // Please refer to the comments above when reading this class code, it's
833 // absolutely symmetrical to wxGridBackwardOperations.
834 class wxGridForwardOperations
: public wxGridDirectionOperations
837 wxGridForwardOperations(wxGrid
*grid
, const wxGridOperations
& oper
)
838 : wxGridDirectionOperations(grid
, oper
),
839 m_numLines(oper
.GetNumberOfLines(grid
))
843 virtual bool IsAtBoundary(const wxGridCellCoords
& coords
) const
845 wxASSERT_MSG( m_oper
.Select(coords
) < m_numLines
, "invalid row/column" );
847 int pos
= GetLinePos(coords
);
848 while ( pos
< m_numLines
- 1 )
850 int line
= GetLineAt(++pos
);
851 if ( IsLineVisible(line
) )
858 virtual void Advance(wxGridCellCoords
& coords
) const
860 int pos
= GetLinePos(coords
);
863 wxCHECK_RET( pos
< m_numLines
- 1,
864 "can't advance when already at boundary" );
866 int line
= GetLineAt(++pos
);
867 if ( IsLineVisible(line
) )
869 m_oper
.Set(coords
, line
);
875 virtual int MoveByPixelDistance(int line
, int distance
) const
877 int pos
= m_oper
.GetLineStartPos(m_grid
, line
);
878 return m_oper
.PosToLine(m_grid
, pos
+ distance
, true);
882 const int m_numLines
;
885 // ----------------------------------------------------------------------------
886 // data structures used for the data type registry
887 // ----------------------------------------------------------------------------
889 struct wxGridDataTypeInfo
891 wxGridDataTypeInfo(const wxString
& typeName
,
892 wxGridCellRenderer
* renderer
,
893 wxGridCellEditor
* editor
)
894 : m_typeName(typeName
), m_renderer(renderer
), m_editor(editor
)
897 ~wxGridDataTypeInfo()
899 wxSafeDecRef(m_renderer
);
900 wxSafeDecRef(m_editor
);
904 wxGridCellRenderer
* m_renderer
;
905 wxGridCellEditor
* m_editor
;
907 wxDECLARE_NO_COPY_CLASS(wxGridDataTypeInfo
);
911 WX_DEFINE_ARRAY_WITH_DECL_PTR(wxGridDataTypeInfo
*, wxGridDataTypeInfoArray
,
912 class WXDLLIMPEXP_ADV
);
915 class WXDLLIMPEXP_ADV wxGridTypeRegistry
918 wxGridTypeRegistry() {}
919 ~wxGridTypeRegistry();
921 void RegisterDataType(const wxString
& typeName
,
922 wxGridCellRenderer
* renderer
,
923 wxGridCellEditor
* editor
);
925 // find one of already registered data types
926 int FindRegisteredDataType(const wxString
& typeName
);
928 // try to FindRegisteredDataType(), if this fails and typeName is one of
929 // standard typenames, register it and return its index
930 int FindDataType(const wxString
& typeName
);
932 // try to FindDataType(), if it fails see if it is not one of already
933 // registered data types with some params in which case clone the
934 // registered data type and set params for it
935 int FindOrCloneDataType(const wxString
& typeName
);
937 wxGridCellRenderer
* GetRenderer(int index
);
938 wxGridCellEditor
* GetEditor(int index
);
941 wxGridDataTypeInfoArray m_typeinfo
;
945 #endif // _WX_GENERIC_GRID_PRIVATE_H_