X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a660d684eda27638bca0384b2058911a31c8e845..3c59549689ca9333b0dde255dc7d46e0539183e8:/docs/latex/wx/grid.tex diff --git a/docs/latex/wx/grid.tex b/docs/latex/wx/grid.tex index c8d5bce02a..4dcd0089f5 100644 --- a/docs/latex/wx/grid.tex +++ b/docs/latex/wx/grid.tex @@ -1,517 +1,1690 @@ \section{\class{wxGrid}}\label{wxgrid} -wxGrid is a class for displaying and editing tabular information. +wxGrid and its related classes are used for displaying and editing tabular +data. They provide a rich set of features for display, editing, and +interacting with a variety of data sources. For simple applications, and to +help you get started, wxGrid is the only class you need to refer to +directly. It will set up default instances of the other classes and manage +them for you. For more complex applications you can derive your own +classes for custom grid views, grid data tables, cell editors and +renderers. The \helpref{wxGrid classes overview}{gridoverview} has +examples of simple and more complex applications, explains the +relationship between the various grid classes and has a summary of the +keyboard shortcuts and mouse functions provided by wxGrid. + +wxGrid has been greatly expanded and redesigned for wxWindows 2.2 +onwards. If you have been using the old wxGrid class you will probably +want to have a look at the \helpref{wxGrid classes overview}{gridoverview} to see +how things have changed. The new grid classes are reasonably backward-compatible +but there are some exceptions. There are also easier ways of doing many things compared to +the previous implementation. \wxheading{Derived from} -\helpref{wxPanel}{wxpanel}\\ +\helpref{wxScrolledWindow}{wxscrolledwindow}\\ \helpref{wxWindow}{wxwindow}\\ \helpref{wxEvtHandler}{wxevthandler}\\ \helpref{wxObject}{wxobject} +\wxheading{Include files} + + + \wxheading{Window styles} -There are no specific window styles for this class. +There are presently no specific window styles for wxGrid. + +\wxheading{Event handling} + +\input gridevt.inc + +The event handler for the following functions takes a + \helpref{wxGridSizeEvent}{wxgridsizeevent} parameter. + +\twocolwidtha{7cm} +\begin{twocollist}\itemsep=0pt +\twocolitem{{\bf EVT\_GRID\_COL\_SIZE(func)}}{The user resized a column by dragging it. Processes a wxEVT\_GRID\_COL\_SIZE.} +\twocolitem{{\bf EVT\_GRID\_ROW\_SIZE(func)}}{The user resized a row by dragging it. Processes a wxEVT\_GRID\_ROW\_SIZE.} +\end{twocollist}% + +The event handler for the following functions takes a + \helpref{wxGridRangeSelectEvent}{wxgridrangeselectevent} parameter. + +\twocolwidtha{7cm} +\begin{twocollist}\itemsep=0pt +\twocolitem{{\bf EVT\_GRID\_RANGE\_SELECT(func)}}{The user selected a group of contiguous cells. Processes a wxEVT\_GRID\_RANGE\_SELECT.} +\end{twocollist}% -See also \helpref{window styles overview}{windowstyles}. +The event handler for the following functions takes a + \helpref{wxGridEditorCreatedEvent}{wxgrideditorcreatedevent} parameter. + +\twocolwidtha{7cm} +\begin{twocollist}\itemsep=0pt +\twocolitem{{\bf EVT\_GRID\_EDITOR\_CREATED(func)}}{The editor for a cell was created. Processes a wxEVT\_GRID\_EDITOR\_CREATED.} +\end{twocollist}% \wxheading{See also} -\helpref{wxGrid classes overview}{gridoverview} +\helpref{wxGrid overview}{gridoverview} + +%%%%%%%%%%% FUNCTION GROUPS %%%%%%%%%%%%% +\latexignore{\rtfignore{\wxheading{Function groups}}} + +\membersection{Constructors and initialization} + +\helpref{wxGrid}{wxgridctor}\\ +\helpref{\destruct{wxGrid}}{wxgriddtor}\\ +\helpref{CreateGrid}{wxgridcreategrid}\\ +\helpref{SetTable}{wxgridsettable} + +\membersection{Display format} + +\membersection{Selection functions} + +\helpref{wxGrid::ClearSelection}{wxgridclearselection}\\ +\helpref{wxGrid::IsSelection}{wxgridisselection}\\ +\helpref{wxGrid::SelectAll}{wxgridselectall}\\ +\helpref{wxGrid::SelectBlock}{wxgridselectblock}\\ +\helpref{wxGrid::SelectCol}{wxgridselectcol}\\ +\helpref{wxGrid::SelectRow}{wxgridselectrow} + +%%%%%%%%% MEMBER FUNCTIONS %%%%%%%%%% +\helponly{\insertatlevel{2}{ -\latexignore{\rtfignore{\wxheading{Members}}} +\wxheading{Members} -\membersection{wxGrid::wxGrid}\label{wxgridconstr} +}} -\func{void}{wxGrid}{\param{wxWindow* }{parent}, \param{const wxWindowID}{ id}, \param{const wxPoint\&}{ pos}, -\rtfsp\param{const wxSize\&}{ size}, \param{const long}{ style=0}, \param{const wxString\& }{name="grid"}} +\membersection{wxGrid::wxGrid}\label{wxgridctor} -Constructor. Before using a wxGrid object, you must call CreateGrid to set up the required rows and columns. +\func{}{wxGrid}{\void} -\membersection{wxGrid::AdjustScrollbars}\label{wxgridadjustscrollbars} +Default constructor -\func{void}{AdjustScrollbars}{\void} +\func{}{wxGrid}{\param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize}, \param{long }{style = wxWANTS\_CHARS}, \param{const wxString\& }{name = wxPanelNameStr}} -Call this function whenever a change has been made via the API that might alter the scrollbar characteristics: -particularly when adding or deleting rows, or changing row or column dimensions. For example, -removing rows might make it unnecessary to show the vertical scrollbar. +Constructor to create a grid object. Call either \helpref{wxGrid::CreateGrid}{wxgridcreategrid} or +\helpref{wxGrid::SetTable}{wxgridsettable} directly after this to initialize the grid before using +it. + +\membersection{wxGrid::\destruct{wxGrid}}\label{wxgriddtor} + +\func{}{\destruct{wxGrid}}{\void} + +Destructor. This will also destroy the associated grid table unless you passed a table +object to the grid and specified that the grid should not take ownership of the +table (see \helpref{wxGrid::SetTable}{wxgridsettable}). \membersection{wxGrid::AppendCols}\label{wxgridappendcols} -\func{bool}{AppendCols}{\param{int}{ n=1}, \param{bool}{ updateLabels=TRUE}} +\func{bool}{AppendCols}{\param{int }{numCols = 1}, \param{bool }{updateLabels = true}} + +Appends one or more new columns to the right of the grid and returns true if +successful. The updateLabels argument is not used at present. -Appends {\it n} columns to the grid. If {\it updateLabels} is TRUE, -the function OnChangeLabels is called to give the application the opportunity to relabel. +If you are using a derived grid table class you will need to override +\helpref{wxGridTableBase::AppendCols}{wxgridtablebaseappendcols}. See +\helpref{wxGrid::InsertCols}{wxgridinsertcols} for further information. \membersection{wxGrid::AppendRows}\label{wxgridappendrows} -\func{bool}{AppendRows}{\param{int}{ n=1}, \param{bool}{ updateLabels=TRUE}} +\func{bool}{AppendRows}{\param{int }{numRows = 1}, \param{bool }{updateLabels = true}} + +Appends one or more new rows to the bottom of the grid and returns true if +successful. The updateLabels argument is not used at present. + +If you are using a derived grid table class you will need to override +\helpref{wxGridTableBase::AppendRows}{wxgridtablebaseappendrows}. See +\helpref{wxGrid::InsertRows}{wxgridinsertrows} for further information. + +\membersection{wxGrid::AutoSize}\label{wxgridautosize} + +\func{void}{AutoSize}{\void} + +Automatically sets the height and width of all rows and columns to fit their contents. + +\wxheading{Note}\\ +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. + +\membersection{wxGrid::AutoSizeColumn}\label{wxgridautosizecolumn} + +\func{void}{AutoSizeColumn}{\param{int }{col}, \param{bool }{setAsMin = true}} + +Automatically sizes the column to fit its contents. If setAsMin is true the calculated width will +also be set as the minimal width for the column. + +\wxheading{Note}\\ +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. + +\membersection{wxGrid::AutoSizeColumns}\label{wxgridautosizecolumns} + +\func{void}{AutoSizeColumns}{\param{bool }{setAsMin = true}} -Appends {\it n} rows to the grid. If {\it updateLabels} is TRUE, -the function OnChangeLabels is called to give the application the opportunity to relabel. +Automatically sizes all columns to fit their contents. If setAsMin is true the calculated widths will +also be set as the minimal widths for the columns. + +\wxheading{Note}\\ +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. + +\membersection{wxGrid::AutoSizeRow}\label{wxgridautosizerow} + +\func{void}{AutoSizeRow}{\param{int }{row}, \param{bool }{setAsMin = true}} + +Automatically sizes the row to fit its contents. If setAsMin is true the calculated height will +also be set as the minimal height for the row. + +\wxheading{Note}\\ +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. + +\membersection{wxGrid::AutoSizeRows}\label{wxgridautosizerows} + +\func{void}{AutoSizeRows}{\param{bool }{setAsMin = true}} + +Automatically sizes all rows to fit their contents. If setAsMin is true the calculated heights will +also be set as the minimal heights for the rows. + +\wxheading{Note}\\ +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. \membersection{wxGrid::BeginBatch}\label{wxgridbeginbatch} \func{void}{BeginBatch}{\void} -Start a BeginBatch/EndBatch pair between which, calls to SetCellValue or -SetCellBitmap will not cause a refresh. This allows you to speed up some operations -(for example, setting several hundred cell values). You can nest, but not overlap, -these two functions. +Increments the grid's batch count. When the count is greater than zero repainting of +the grid is suppressed. Each call to BeginBatch must be matched by a later call to +\helpref{wxGrid::EndBatch}{wxgridendbatch}. Code that does a lot of grid +modification can be enclosed between BeginBatch and EndBatch calls to avoid +screen flicker. The final EndBatch will cause the grid to be repainted. -See also \helpref{wxGrid::EndBatch}{wxgridendbatch}, \helpref{wxGrid::GetBatchCount}{wxgridgetbatchcount}. +\membersection{wxGrid::CanDragColSize}\label{wxgridcandragcolsize} -\membersection{wxGrid::CellHitTest}\label{wxgridcellhittest} +\func{bool}{CanDragColSize}{\void} -\func{bool}{CellHitTest}{\param{int}{ x}, \param{int}{ y}, \param{int *}{row}, \param{int *}{col}} +Returns true if columns can be resized by dragging with the mouse. Columns can be resized +by dragging the edges of their labels. If grid line dragging is enabled they can also be +resized by dragging the right edge of the column in the grid cell area +(see \helpref{wxGrid::EnableDragGridSize}{wxgridenabledraggridsize}). -Returns TRUE if the x, y panel position coincides with a cell. If so, {\it row} and {\it col} are -returned. +\membersection{wxGrid::CanDragRowSize}\label{wxgridcandragrowsize} -\membersection{wxGrid::CreateGrid}\label{wxgridcreategrid} +\func{bool}{CanDragRowSize}{\void} + +Returns true if rows can be resized by dragging with the mouse. Rows can be resized +by dragging the edges of their labels. If grid line dragging is enabled they can also be +resized by dragging the lower edge of the row in the grid cell area +(see \helpref{wxGrid::EnableDragGridSize}{wxgridenabledraggridsize}). + +\membersection{wxGrid::CanDragGridSize}\label{wxgridcandraggridsize} + +\func{bool}{CanDragGridSize}{\void} + +Return true if the dragging of grid lines to resize rows and columns is enabled or false otherwise. + +\membersection{wxGrid::CanEnableCellControl}\label{wxgridcanenablecellcontrol} + +\constfunc{bool}{CanEnableCellControl}{\void} -\func{bool}{CreateGrid}{\param{int}{ rows}, \param{int}{ cols}, \param{wxString **}{cellValues=NULL}, - \param{short *}{widths=NULL}, \param{short}{ defaultWidth=wxGRID\_DEFAULT\_CELL\_WIDTH}, - \param{short}{ defaultHeight=wxGRID\_DEFAULT\_CELL\_HEIGHT}} +Returns true if the in-place edit control for the current grid cell can be used and +false otherwise (e.g. if the current cell is read-only). -Creates a grid {\it rows} high and {\it cols} wide. You can optionally specify an array of initial values -and widths, and/or default cell width and height. +\membersection{wxGrid::CellToRect}\label{wxgridcelltorect} -Call this function after creating the wxGrid object. +\func{wxRect}{CellToRect}{\param{int }{row}, \param{int }{col}} -\membersection{wxGrid::CurrentCellVisible}\label{wxgridcurrentcellvisible} +\func{wxRect}{CellToRect}{\param{const wxGridCellCoords\& }{coords}} -\func{bool}{CurrentCellVisible}{\void} +Return the rectangle corresponding to the grid cell's size and position in logical +coordinates. -Returns TRUE if the currently selected cell is visible, FALSE otherwise. +\membersection{wxGrid::ClearGrid}\label{wxgridcleargrid} + +\func{void}{ClearGrid}{\void} + +Clears all data in the underlying grid table and repaints the grid. The table is not deleted by +this function. If you are using a derived table class then you need to override +\helpref{wxGridTableBase::Clear}{wxgridtablebaseclear} for this function to have any effect. + +\membersection{wxGrid::ClearSelection}\label{wxgridclearselection} + +\func{void}{ClearSelection}{\void} + +Deselects all cells that are currently selected. + +\membersection{wxGrid::CreateGrid}\label{wxgridcreategrid} + +\func{bool}{CreateGrid}{\param{int }{numRows}, \param{int }{numCols}, \param{wxGrid::wxGridSelectionModes }{selmode = wxGrid::wxGridSelectCells}} + +Creates a grid with the specified initial number of rows and columns. +Call this directly after the grid constructor. When you use this +function wxGrid will create and manage a simple table of string values +for you. All of the grid data will be stored in memory. + +For applications with more complex data types or relationships, or for +dealing with very large datasets, you should derive your own grid table +class and pass a table object to the grid with \helpref{wxGrid::SetTable}{wxgridsettable}. \membersection{wxGrid::DeleteCols}\label{wxgriddeletecols} -\func{bool}{DeleteCols}{\param{int}{ pos=0}, \param{int}{ n=1}, \param{bool}{ updateLabels=TRUE}} +\func{bool}{DeleteCols}{\param{int }{pos = 0}, \param{int }{numCols = 1}, \param{bool }{updateLabels = true}} -Deletes {\it n} columns from the grid at position {\it pos}. If {\it updateLabels} is TRUE, -the function OnChangeLabels is called to give the application the opportunity to relabel. +Deletes one or more columns from a grid starting at the specified position and returns +true if successful. The updateLabels argument is not used at present. + +If you are using a derived grid table class you will need to override +\helpref{wxGridTableBase::DeleteCols}{wxgridtablebasedeletecols}. See +\helpref{wxGrid::InsertCols}{wxgridinsertcols} for further information. \membersection{wxGrid::DeleteRows}\label{wxgriddeleterows} -\func{bool}{DeleteRows}{\param{int}{ pos=0}, \param{int}{ n=1}, \param{bool}{ updateLabels=TRUE}} +\func{bool}{DeleteRows}{\param{int }{pos = 0}, \param{int }{numRows = 1}, \param{bool }{updateLabels = true}} + +Deletes one or more rows from a grid starting at the specified position and returns +true if successful. The updateLabels argument is not used at present. + +If you are using a derived grid table class you will need to override +\helpref{wxGridTableBase::DeleteRows}{wxgridtablebasedeleterows}. See +\helpref{wxGrid::InsertRows}{wxgridinsertrows} for further information. + +\membersection{wxGrid::DisableCellEditControl}\label{wxgriddisablecelleditcontrol} + +\func{void}{DisableCellEditControl}{\void} + +Disables in-place editing of grid cells. +Equivalent to calling EnableCellEditControl(false). -Deletes {\it n} rows from the grid at position {\it pos}. If {\it updateLabels} is TRUE, -the function OnChangeLabels is called to give the application the opportunity to relabel. +\membersection{wxGrid::DisableDragColSize}\label{wxgriddisabledragcolsize} + +\func{void}{DisableDragColSize}{\void} + +Disables column sizing by dragging with the mouse. Equivalent to passing false to +\helpref{wxGrid::EnableDragColSize}{wxgridenabledragcolsize}. + +\membersection{wxGrid::DisableDragGridSize}\label{wxgriddisabledraggridsize} + +\func{void}{DisableDragGridSize}{\void} + +Disable mouse dragging of grid lines to resize rows and columns. Equivalent to passing +false to \helpref{wxGrid::EnableDragGridSize}{wxgridenabledraggridsize} + +\membersection{wxGrid::DisableDragRowSize}\label{wxgriddisabledragrowsize} + +\func{void}{DisableDragRowSize}{\void} + +Disables row sizing by dragging with the mouse. Equivalent to passing false to +\helpref{wxGrid::EnableDragRowSize}{wxgridenabledragrowsize}. + +\membersection{wxGrid::EnableCellEditControl}\label{wxgridenablecelleditcontrol} + +\func{void}{EnableCellEditControl}{\param{bool }{enable = true}} + +Enables or disables in-place editing of grid cell data. The grid will issue either a +wxEVT\_GRID\_EDITOR\_SHOWN or wxEVT\_GRID\_EDITOR\_HIDDEN event. + +\membersection{wxGrid::EnableDragColSize}\label{wxgridenabledragcolsize} + +\func{void}{EnableDragColSize}{\param{bool }{enable = true}} + +Enables or disables column sizing by dragging with the mouse. + +\membersection{wxGrid::EnableDragGridSize}\label{wxgridenabledraggridsize} + +\func{void}{EnableDragGridSize}{\param{bool }{enable = true}} + +Enables or disables row and column resizing by dragging gridlines with the mouse. + +\membersection{wxGrid::EnableDragRowSize}\label{wxgridenabledragrowsize} + +\func{void}{EnableDragRowSize}{\param{bool }{enable = true}} + +Enables or disables row sizing by dragging with the mouse. + +\membersection{wxGrid::EnableEditing}\label{wxgridenableediting} + +\func{void}{EnableEditing}{\param{bool }{edit}} + +If the edit argument is false this function sets the whole grid as read-only. If the +argument is true the grid is set to the default state where cells may be editable. In the +default state you can set single grid cells and whole rows and columns to be editable or +read-only via +\helpref{wxGridCellAttribute::SetReadOnly}{wxgridcellattrsetreadonly}. For single +cells you can also use the shortcut function +\helpref{wxGrid::SetReadOnly}{wxgridsetreadonly}. + +For more information about controlling grid cell attributes see the +\helpref{wxGridCellAttr}{wxgridcellattr} cell attribute class and the +\helpref{wxGrid classes overview}{gridoverview}. + +\membersection{wxGrid::EnableGridLines}\label{wxgridenablegridlines} + +\func{void}{EnableGridLines}{\param{bool }{enable = true}} + +Turns the drawing of grid lines on or off. \membersection{wxGrid::EndBatch}\label{wxgridendbatch} \func{void}{EndBatch}{\void} -End a BeginBatch/EndBatch pair between which, calls to SetCellValue or -SetCellBitmap will not cause a refresh. This allows you to speed up some operations -(for example, setting several hundred cell values). You can nest, but not overlap, -these two functions. +Decrements the grid's batch count. When the count is greater than zero repainting of +the grid is suppressed. Each previous call to +\helpref{wxGrid::BeginBatch}{wxgridbeginbatch} must be matched by a later call to +EndBatch. Code that does a lot of grid modification can be enclosed between +BeginBatch and EndBatch calls to avoid screen flicker. The final EndBatch will +cause the grid to be repainted. + +\membersection{wxGrid::ForceRefresh}\label{wxgridforcerefresh} -See also \helpref{wxGrid::BeginBatch}{wxgridbeginbatch}, \helpref{wxGrid::GetBatchCount}{wxgridgetbatchcount}. +\func{void}{ForceRefresh}{\void} + +Causes immediate repainting of the grid. Use this instead of the usual wxWindow::Refresh. \membersection{wxGrid::GetBatchCount}\label{wxgridgetbatchcount} -\func{void}{GetBatchCount}{\void} +\func{int}{GetBatchCount}{\void} -Return the level of batch nesting. This is initially zero, and will be incremented -every time BeginBatch is called, and decremented when EndBatch is called. When the -batch count is more zero, some functions (such as SetCellValue and SetCellBitmap) will -not refresh the cell. +Returns the number of times that \helpref{wxGrid::BeginBatch}{wxgridbeginbatch} has been called +without (yet) matching calls to \helpref{wxGrid::EndBatch}{wxgridendbatch}. While +the grid's batch count is greater than zero the display will not be updated. -See also \helpref{wxGrid::BeginBatch}{wxgridbeginbatch}, \helpref{wxGrid::EndBatch}{wxgridendbatch}. +\membersection{wxGrid::GetCellAlignment}\label{wxgridgetcellalignment} -\membersection{wxGrid::GetCell}\label{wxgridgetcell} +\func{void}{GetCellAlignment}{\param{int }{row}, \param{int }{col}, \param{int* }{horiz}, \param{int* }{vert}} -\func{wxGridCell *}{GetCell}{\param{int}{ row}, \param{int}{ col}} +Sets the arguments to the horizontal and vertical text alignment values for the +grid cell at the specified location. -Returns the grid cell object associated with this position. +Horizontal alignment will be one of wxALIGN\_LEFT, wxALIGN\_CENTRE or wxALIGN\_RIGHT. \\ +Vertical alignment will be one of wxALIGN\_TOP, wxALIGN\_CENTRE or wxALIGN\_BOTTOM. -wxGenericGrid implementation only. +\perlnote{This method only takes the parameters {\tt row} and {\tt col} and +returns a 2-element list {\tt ( horiz, vert )}.} -\membersection{wxGrid::GetCellAlignment}\label{wxgridgetcellalignment} +\membersection{wxGrid::GetCellBackgroundColour}\label{wxgridgetcellbackgroundcolour} -\func{int}{GetCellAlignment}{\param{int}{ row}, \param{int}{ col}} +\func{wxColour}{GetCellBackgroundColour}{\param{int }{row}, \param{int }{col}} -\func{int}{GetCellAlignment}{\void} +Returns the background colour of the cell at the specified location. -Sets the text alignment for the cell at the given position, or the global alignment value. -The return value is wxLEFT, wxRIGHT or wxCENTRE. +\membersection{wxGrid::GetCellEditor}\label{wxgridgetcelleditor} -\membersection{wxGrid::GetCellBackgroundColour}\label{wxgridgetcellbackgroundcolour} +\func{wxGridCellEditor*}{GetCellEditor}{\param{int }{row}, \param{int }{col}} + +Returns a pointer to the editor for the cell at the specified location. + +See \helpref{wxGridCellEditor}{wxgridcelleditor} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. + +\membersection{wxGrid::GetCellFont}\label{wxgridgetcellfont} -\func{wxColour\&}{GetCellBackgroundColour}{\param{int}{ row}, \param{int}{ col}} +\func{wxFont}{GetCellFont}{\param{int }{row}, \param{int }{col}} -\func{wxColour\&}{GetCellBackgroundColour}{\void} +Returns the font for text in the grid cell at the specified location. -Gets the background colour for the cell at the given position, or the global background colour. +\membersection{wxGrid::GetCellRenderer}\label{wxgridgetcellrenderer} -\membersection{wxGrid::GetCells}\label{wxgridgetcells} +\func{wxGridCellRenderer*}{GetCellRenderer}{\param{int }{row}, \param{int }{col}} -\func{wxGridCell ***}{GetCells}{\void} +Returns a pointer to the renderer for the grid cell at the specified location. -Returns the array of grid cell object associated with this wxGrid. +See \helpref{wxGridCellRenderer}{wxgridcellrenderer} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. \membersection{wxGrid::GetCellTextColour}\label{wxgridgetcelltextcolour} -\func{wxColour\&}{GetCellTextColour}{\param{int}{ row}, \param{int}{ col}} +\func{wxColour}{GetCellTextColour}{\param{int }{row}, \param{int }{col}} -\func{wxColour\&}{GetCellTextColour}{\void} +Returns the text colour for the grid cell at the specified location. -Gets the text colour for the cell at the given position, or the global text colour. +\membersection{wxGrid::GetCellValue}\label{wxgridgetcellvalue} -\membersection{wxGrid::GetCellTextFont}\label{wxgridgetcelltextfont} +\func{wxString}{GetCellValue}{\param{int }{row}, \param{int }{col}} -\func{wxFont *}{GetCellTextFont}{\param{int}{ row}, \param{int}{ col}} +\func{wxString}{GetCellValue}{\param{const wxGridCellCoords\&}{coords}} -\func{wxFont *}{GetCellTextFont}{\void} +Returns the string contained in the cell at the specified location. For simple applications where a +grid object automatically uses a default grid table of string values you use this function together +with \helpref{wxGrid::SetCellValue}{wxgridsetcellvalue} to access cell values. -Gets the text font for the cell at the given position, or the global text font. +For more complex applications where you have derived your own grid table class that contains +various data types (e.g. numeric, boolean or user-defined custom types) then you only use this +function for those cells that contain string values. -\membersection{wxGrid::GetCellValue}\label{wxgridgetcellvalue} +See \helpref{wxGridTableBase::CanGetValueAs}{wxgridtablebasecangetvalueas} +and the \helpref{wxGrid overview}{gridoverview} for more information. -\func{wxString\&}{GetCellValue}{\param{int}{ row}, \param{int}{ col}} +\membersection{wxGrid::GetColLabelAlignment}\label{wxgridgetcollabelalignment} -Returns the cell value at the given position. +\func{void}{GetColLabelAlignment}{\param{int* }{horiz}, \param{int* }{vert}} -\membersection{wxGrid::GetCols}\label{wxgridgetcols} +Sets the arguments to the current column label alignment values. -\func{int}{GetCols}{\void} +Horizontal alignment will be one of wxLEFT, wxCENTRE or wxRIGHT. \\ +Vertical alignment will be one of wxTOP, wxCENTRE or wxBOTTOM. -Returns the number of columns in the grid. +\perlnote{This method takes no parameters and +returns a 2-element list {\tt ( horiz, vert )}.} -\membersection{wxGrid::GetColumnWidth}\label{wxgridcolumnwidth} +\membersection{wxGrid::GetColLabelSize}\label{wxgridgetcollabelsize} -\func{int}{GetColumnWidth}{\param{int}{ col}} +\func{int}{GetColLabelSize}{\void} -Gets the width in pixels for column {\it col}. +Returns the current height of the column labels. -\membersection{wxGrid::GetCurrentRect}\label{wxgridgetcurrentrect} +\membersection{wxGrid::GetColLabelValue}\label{wxgridgetcollabelvalue} -\func{wxRectangle *}{GetCurrentRect}{\void} +\func{wxString}{GetColLabelValue}{\param{int }{col}} -Returns a pointer to the rectangle enclosing the currently selected cell. -Do not delete this pointer. +Returns the specified column label. The default grid table class provides column labels of +the form A,B...Z,AA,AB...ZZ,AAA... If you are using a custom grid table you can override +\helpref{wxGridTableBase::GetColLabelValue}{wxgridtablebasegetcollabelvalue} to provide +your own labels. -\membersection{wxGrid::GetCursorColumn}\label{wxgridgetcursorcolumn} +\membersection{wxGrid::GetColSize}\label{wxgridgetcolsize} -\func{int}{GetCursorColumn}{\void} +\func{int}{GetColSize}{\param{int }{col}} -Returns the column position of the currently selected cell. +Returns the width of the specified column. -\membersection{wxGrid::GetCursorRow}\label{wxgridgetcursorrow} +\membersection{wxGrid::GetDefaultCellAlignment}\label{wxgridgetdefaultcellalignment} -\func{int}{GetCursorRow}{\void} +\func{void}{GetDefaultCellAlignment}{\param{int* }{horiz}, \param{int* }{vert}} -Returns the row position of the currently selected cell. +Sets the arguments to the current default horizontal and vertical text alignment +values. -\membersection{wxGrid::GetEditable}\label{wxgridgeteditable} +Horizontal alignment will be one of wxALIGN\_LEFT, wxALIGN\_CENTRE or wxALIGN\_RIGHT. \\ +Vertical alignment will be one of wxALIGN\_TOP, wxALIGN\_CENTRE or wxALIGN\_BOTTOM. -\func{bool}{GetEditable}{\void} +\membersection{wxGrid::GetDefaultCellBackgroundColour}\label{wxgridgetdefaultcellbackgroundcolour} -Returns TRUE if the grid cells can be edited. +\func{wxColour}{GetDefaultCellBackgroundColour}{\void} -\membersection{wxGrid::GetHorizScrollBar}\label{wxgridgethorizscrollbar} +Returns the current default background colour for grid cells. -\func{wxScrollBar *}{GetHorizScrollBar}{\void} +\membersection{wxGrid::GetDefaultCellFont}\label{wxgridgetdefaultcellfont} -Returns a pointer to the horizontal scrollbar. +\func{wxFont}{GetDefaultCellFont}{\void} -\membersection{wxGrid::GetLabelAlignment}\label{wxgridgetlabelalignment} +Returns the current default font for grid cell text. + +\membersection{wxGrid::GetDefaultCellTextColour}\label{wxgridgetdefaultcelltextcolour} + +\func{wxColour}{GetDefaultCellTextColour}{\void} + +Returns the current default colour for grid cell text. + +\membersection{wxGrid::GetDefaultColLabelSize}\label{wxgridgetdefaultcollabelsize} + +\func{int}{GetDefaultColLabelSize}{\void} + +Returns the default height for column labels. + +\membersection{wxGrid::GetDefaultColSize}\label{wxgridgetdefaultcolsize} + +\func{int}{GetDefaultColSize}{\void} + +Returns the current default width for grid columns. + +\membersection{wxGrid::GetDefaultEditor}\label{wxgridgetdefaulteditor} + +\constfunc{wxGridCellEditor*}{GetDefaultEditor}{\void} + +Returns a pointer to the current default grid cell editor. + +See \helpref{wxGridCellEditor}{wxgridcelleditor} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. + +\membersection{wxGrid::GetDefaultRenderer}\label{wxgridgetdefaultrenderer} + +\constfunc{wxGridCellRenderer*}{GetDefaultRenderer}{\void} + +Returns a pointer to the current default grid cell renderer. -\func{int}{GetLabelAlignment}{\param{int}{ orientation}} +See \helpref{wxGridCellRenderer}{wxgridcellrenderer} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. -Gets the row or column label alignment. {\it orientation} should -be wxHORIZONTAL to specify column label, wxVERTICAL to specify row label.\rtfsp -{\it alignment} should be wxCENTRE, wxLEFT or wxRIGHT. +\membersection{wxGrid::GetDefaultRowLabelSize}\label{wxgridgetdefaultrowlabelsize} + +\func{int}{GetDefaultRowLabelSize}{\void} + +Returns the default width for the row labels. + +\membersection{wxGrid::GetDefaultRowSize}\label{wxgridgetdefaultrowsize} + +\func{int}{GetDefaultRowSize}{\void} + +Returns the current default height for grid rows. + +\membersection{wxGrid::GetGridCursorCol}\label{wxgridgetgridcursorcol} + +\func{int}{GetGridCursorCol}{\void} + +Returns the current grid cell column position. + +\membersection{wxGrid::GetGridCursorRow}\label{wxgridgetgridcursorrow} + +\func{int}{GetGridCursorRow}{\void} + +Returns the current grid cell row position. + +\membersection{wxGrid::GetGridLineColour}\label{wxgridgetgridlinecolour} + +\func{wxColour}{GetGridLineColour}{\void} + +Returns the colour used for grid lines. + +\membersection{wxGrid::GridLinesEnabled}\label{wxgridgridlinesenabled} + +\func{bool}{GridLinesEnabled}{\void} + +Returns true if drawing of grid lines is turned on, false otherwise. \membersection{wxGrid::GetLabelBackgroundColour}\label{wxgridgetlabelbackgroundcolour} -\func{wxColour\&}{GetLabelBackgroundColour}{\void} +\func{wxColour}{GetLabelBackgroundColour}{\void} -Gets a row and column label text colour. +Returns the colour used for the background of row and column labels. -\membersection{wxGrid::GetLabelSize}\label{wxgridgetlabelsize} +\membersection{wxGrid::GetLabelFont}\label{wxgridgetlabelfont} -\func{int}{GetLabelSize}{\param{int}{ orientation}} +\func{wxFont}{GetLabelFont}{\void} -Gets the row label height, or column label width, in pixels. {\it orientation} should -be wxHORIZONTAL to specify column label, wxVERTICAL to specify row label. +Returns the font used for row and column labels. \membersection{wxGrid::GetLabelTextColour}\label{wxgridgetlabeltextcolour} -\func{wxColour\&}{GetLabelTextColour}{\void} +\func{wxColour}{GetLabelTextColour}{\void} -Gets a row and column label text colour. +Returns the colour used for row and column label text. -\membersection{wxGrid::GetLabelTextFont}\label{wxgridgetlabeltextfont} +\membersection{wxGrid::GetNumberCols}\label{wxgridgetnumbercols} -\func{wxFont *}{GetLabelTextFont}{\void} +\func{int}{GetNumberCols}{\void} -Gets the font to be used for the row and column labels. +Returns the total number of grid columns (actually the number of columns in the underlying grid +table). -\membersection{wxGrid::GetLabelValue}\label{wxgridgetlabelvalue} +\membersection{wxGrid::GetNumberRows}\label{wxgridgetnumberrows} -\func{wxString\&}{GetLabelValue}{\param{int}{ orientation}, \param{int}{ pos}} +\func{int}{GetNumberRows}{\void} -Gets a row or column label value. {\it orientation} should -be wxHORIZONTAL to specify column label, wxVERTICAL to specify row label.\rtfsp -{\it pos} is the label position. +Returns the total number of grid rows (actually the number of rows in the underlying grid table). -\membersection{wxGrid::GetRowHeight}\label{wxgridgetrowheight} +\membersection{wxGrid::GetRowLabelAlignment}\label{wxgridgetrowlabelalignment} -\func{int}{GetRowHeight}{\param{int}{ row}} +\func{void}{GetRowLabelAlignment}{\param{int* }{horiz}, \param{int* }{vert}} -Gets the height in pixels for row {\it row}. +Sets the arguments to the current row label alignment values. -\membersection{wxGrid::GetRows}\label{wxgridgetrows} +Horizontal alignment will be one of wxLEFT, wxCENTRE or wxRIGHT. \\ +Vertical alignment will be one of wxTOP, wxCENTRE or wxBOTTOM. -\func{int}{GetRows}{\void} +\perlnote{This method takes no parameters and +returns a 2-element list {\tt ( horiz, vert )}.} -Returns the number of rows in the grid. +\membersection{wxGrid::GetRowLabelSize}\label{wxgridgetrowlabelsize} -\membersection{wxGrid::GetScrollPosX}\label{wxgridgetscrollposx} +\func{int}{GetRowLabelSize}{\void} -\func{int}{GetScrollPosX}{\void} +Returns the current width of the row labels. -Returns the column scroll position. +\membersection{wxGrid::GetRowLabelValue}\label{wxgridgetrowlabelvalue} -\membersection{wxGrid::GetScrollPosY}\label{wxgridgetscrollposy} +\func{wxString}{GetRowLabelValue}{\param{int }{row}} -\func{int}{GetScrollPosY}{\void} +Returns the specified row label. The default grid table class provides numeric row labels. +If you are using a custom grid table you can override +\helpref{wxGridTableBase::GetRowLabelValue}{wxgridtablebasegetcollabelvalue} to provide +your own labels. + +\membersection{wxGrid::GetRowSize}\label{wxgridgetrowsize} + +\func{int}{GetRowSize}{\param{int }{row}} + +Returns the height of the specified row. + +\membersection{wxGrid::GetSelectionMode}\label{wxgridgetselectionmode} + +\constfunc{wxGrid::wxGridSelectionModes}{GetSelectionMode}{\void} + +Returns the current selection mode, see \helpref{wxGrid::SetSelectionMode}{wxgridsetselectionmode}. -Returns the row scroll position. +\membersection{wxGrid::GetSelectedCells}\label{wxgridgetselectedcells} -\membersection{wxGrid::GetTextItem}\label{wxgridgettextitem} +\constfunc{wxGridCellCoordsArray}{GetSelectedCells}{\void} -\func{wxText *}{GetTextItem}{\void} +Returns an array of singly selected cells. -Returns a pointer to the text item used for entering text into a cell. +\membersection{wxGrid::GetSelectedCols}\label{wxgridgetselectedcols} -\membersection{wxGrid::GetVertScrollBar}\label{wxgridgetvertscrollbar} +\constfunc{wxArrayInt}{GetSelectedCols}{\void} -\func{wxScrollBar *}{GetVertScrollBar}{\void} +Returns an array of selected cols. -Returns a pointer to the vertical scrollbar. +\membersection{wxGrid::GetSelectedRows}\label{wxgridgetselectedrows} + +\constfunc{wxArrayInt}{GetSelectedRows}{\void} + +Returns an array of selected rows. + +\membersection{wxGrid::GetSelectionBlockTopLeft}\label{wxgridgetselectionblocktopleft} + +\constfunc{wxGridCellCoordsArray}{GetSelectionBlockTopLeft}{\void} + +Returns an array of the top left corners of blocks of selected cells, +see \helpref{wxGrid::GetSelectionBlockBottomRight}{wxgridgetselectionblockbottomright}. + +\membersection{wxGrid::GetSelectionBlockBottomRight}\label{wxgridgetselectionblockbottomright} + +\constfunc{wxGridCellCoordsArray}{GetSelectionBlockBottomRight}{\void} + +Returns an array of the bottom right corners of blocks of selected cells, +see \helpref{wxGrid::GetSelectionBlockTopLeft}{wxgridgetselectionblocktopleft}. + +\membersection{wxGrid::GetTable}\label{wxgridgettable} + +\constfunc{wxGridTableBase *}{GetTable}{\void} + +Returns a base pointer to the current table object. + +\membersection{wxGrid::HideCellEditControl}\label{wxgridhidecelleditcontrol} + +\func{void}{HideCellEditControl}{\void} + +Hides the in-place cell edit control. \membersection{wxGrid::InsertCols}\label{wxgridinsertcols} -\func{bool}{InsertCols}{\param{int}{ pos=0}, \param{int}{ n=1}, \param{bool}{ updateLabels=TRUE}} +\func{bool}{InsertCols}{\param{int }{pos = 0}, \param{int }{numCols = 1}, \param{bool }{updateLabels = true}} -Inserts {\it n} number of columns before position {\it pos}. If {\it updateLabels} is TRUE, -the function OnChangeLabels is called to give the application the opportunity to relabel. +Inserts one or more new columns into a grid with the first new column at the +specified position and returns true if successful. The updateLabels argument is not +used at present. + +The sequence of actions begins with the grid object requesting the underlying grid +table to insert new columns. If this is successful the table notifies the grid and the +grid updates the display. For a default grid (one where you have called +\helpref{wxGrid::CreateGrid}{wxgridcreategrid}) this process is automatic. If you are +using a custom grid table (specified with \helpref{wxGrid::SetTable}{wxgridsettable}) +then you must override +\helpref{wxGridTableBase::InsertCols}{wxgridtablebaseinsertcols} in your derived +table class. \membersection{wxGrid::InsertRows}\label{wxgridinsertrows} -\func{bool}{InsertRows}{\param{int}{ pos=0}, \param{int}{ n=1}, \param{bool}{ updateLabels=TRUE}} +\func{bool}{InsertRows}{\param{int }{pos = 0}, \param{int }{numRows = 1}, \param{bool }{updateLabels = true}} -Inserts {\it n} number of rows before position {\it pos}. If {\it updateLabels} is TRUE, -the function OnChangeLabels is called to give the application the opportunity to relabel. +Inserts one or more new rows into a grid with the first new row at the specified +position and returns true if successful. The updateLabels argument is not used at +present. -\membersection{wxGrid::OnActivate}\label{wxgridonactivate} +The sequence of actions begins with the grid object requesting the underlying grid +table to insert new rows. If this is successful the table notifies the grid and the +grid updates the display. For a default grid (one where you have called +\helpref{wxGrid::CreateGrid}{wxgridcreategrid}) this process is automatic. If you are +using a custom grid table (specified with \helpref{wxGrid::SetTable}{wxgridsettable}) +then you must override +\helpref{wxGridTableBase::InsertRows}{wxgridtablebaseinsertrows} in your derived +table class. + +\membersection{wxGrid::IsCellEditControlEnabled}\label{wxgridiscelleditcontrolenabled} + +\constfunc{bool}{IsCellEditControlEnabled}{\void} + +Returns true if the in-place edit control is currently enabled. + +\membersection{wxGrid::IsCurrentCellReadOnly}\label{wxgridiscurrentcellreadonly} + +\constfunc{bool}{IsCurrentCellReadOnly}{\void} + +Returns true if the current cell has been set to read-only +(see \helpref{wxGrid::SetReadOnly}{wxgridsetreadonly}). + +\membersection{wxGrid::IsEditable}\label{wxgridiseditable} + +\func{bool}{IsEditable}{\void} + +Returns false if the whole grid has been set as read-only or true otherwise. +See \helpref{wxGrid::EnableEditing}{wxgridenableediting} for more information about +controlling the editing status of grid cells. + +\membersection{wxGrid::IsInSelection}\label{wxgridisinselection} + +\constfunc{bool}{IsInSelection}{\param{int }{row}, \param{int }{col}} + +\constfunc{bool}{IsInSelection}{\param{const wxGridCellCoords\& }{coords}} + +Is this cell currently selected. + +\membersection{wxGrid::IsReadOnly}\label{wxgridisreadonly} + +\constfunc{bool}{IsReadOnly}{\param{int }{row}, \param{int }{col}} + +Returns true if the cell at the specified location can't be edited. +See also \helpref{wxGrid::IsReadOnly}{wxgridisreadonly}. -\func{void}{OnActivate}{\param{bool}{ active}} +\membersection{wxGrid::IsSelection}\label{wxgridisselection} -Sets the text item to have the focus. Call this function when the wxGrid window should have the -focus, for example from wxFrame::OnActivate. +\func{bool}{IsSelection}{\void} -\membersection{wxGrid::OnChangeLabels}\label{wxgridonchangelabels} +Returns true if there are currently rows, columns or blocks of cells selected. -\func{void}{OnChangeLabels}{\void} +\membersection{wxGrid::IsVisible}\label{wxgridisvisible} -Called when rows and columns are created or deleted, to allow the application an -opportunity to update the labels. By default, columns are labelled alphabetically, -and rows numerically. +\func{bool}{IsVisible}{\param{int }{row}, \param{int }{col}, \param{bool }{wholeCellVisible = true}} -\membersection{wxGrid::OnChangeSelectionLabel}\label{wxgridonchangeselectionlabel} +\func{bool}{IsVisible}{\param{const wxGridCellCoords\& }{coords}, \param{bool }{wholeCellVisible = true}} -\func{void}{OnChangeSelectionLabel}{\void} +Returns true if a cell is either wholly visible (the default) or at least partially +visible in the grid window. -Called when a cell is selected, to allow the application an -opportunity to update the selection label (the label of the wxText item -used for entering cell text). By default, the cell column letter and row -number are concatenated to form the selection label. +\membersection{wxGrid::MakeCellVisible}\label{wxgridmakecellvisible} -\membersection{wxGrid::OnCreateCell}\label{wxgridoncreatecell} +\func{void}{MakeCellVisible}{\param{int }{row}, \param{int }{col}} -\func{wxGridCell *}{OnCreateCell}{\void} +\func{void}{MakeCellVisible}{\param{const wxGridCellCoords\& }{coords}} -Override this virtual function if you want to replace the normal wxGridCell with a derived -class. +Brings the specified cell into the visible grid cell area with minimal scrolling. Does +nothing if the cell is already visible. -\membersection{wxGrid::OnCellLeftClick}\label{wxgridoncellleftclick} +\membersection{wxGrid::MoveCursorDown}\label{wxgridmovecursordown} -\func{void}{OnLeftClick}{\param{int}{ row}, \param{int}{ col}, \param{int}{ x}, \param{int}{ y}, \param{bool}{ control}, \param{bool}{ shift}} +\func{bool}{MoveCursorDown}{\param{bool }{expandSelection}} -Virtual function called when the left button is depressed within a cell, just after OnSelectCell is called. +Moves the grid cursor down by one row. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. -\membersection{wxGrid::OnCellRightClick}\label{wxgridoncellrightclick} +\wxheading{Keyboard}\\ +This function is called for Down cursor key presses or Shift+Down to expand a selection. -\func{void}{OnRightClick}{\param{int}{ row}, \param{int}{ col}, \param{int}{ x}, \param{int}{ y}, \param{bool}{ control}, \param{bool}{ shift}} +\membersection{wxGrid::MoveCursorLeft}\label{wxgridmovecursorleft} -Virtual function called when the right button is depressed within a cell, just after OnSelectCell is called. +\func{bool}{MoveCursorLeft}{\param{bool }{expandSelection}} -\membersection{wxGrid::OnLabelLeftClick}\label{wxgridonlabelleftclick} +Moves the grid cursor left by one column. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. -\func{void}{OnLeftClick}{\param{int}{ row}, \param{int}{ col}, \param{int}{ x}, \param{int}{ y}, \param{bool}{ control}, \param{bool}{ shift}} +\wxheading{Keyboard}\\ +This function is called for Left cursor key presses or Shift+Left to expand a selection. -Virtual function called when the left button is depressed within a -label. +\membersection{wxGrid::MoveCursorRight}\label{wxgridmovecursorright} -{\it row} will be {\it -1} if the click is in the top labels. +\func{bool}{MoveCursorRight}{\param{bool }{expandSelection}} -{\it col} will be {\it -1} if the click is in the left labels. +Moves the grid cursor right by one column. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. -{\it row} and {\it col} will be {\it -1} if the click is in the upper -left corner. +\wxheading{Keyboard}\\ +This function is called for Right cursor key presses or Shift+Right to expand a selection. -\membersection{wxGrid::OnLabelRightClick}\label{wxgridonlabelrightclick} +\membersection{wxGrid::MoveCursorUp}\label{wxgridmovecursorup} -\func{void}{OnRightClick}{\param{int}{ row}, \param{int}{ col}, \param{int}{ x}, \param{int}{ y}, \param{bool}{ control}, \param{bool}{ shift}} +\func{bool}{MoveCursorUp}{\param{bool }{expandSelection}} -Virtual function called when the right button is depressed within a label. +Moves the grid cursor up by one row. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. -{\it row} will be {\it -1} if the click is in the top labels. +\wxheading{Keyboard}\\ +This function is called for Up cursor key presses or Shift+Up to expand a selection. -{\it col} will be {\it -1} if the click is in the left labels. +\membersection{wxGrid::MoveCursorDownBlock}\label{wxgridmovecursordownblock} -{\it row} and {\it col} will be {\it -1} if the click is in the upper -left corner. +\func{bool}{MoveCursorDownBlock}{\param{bool }{expandSelection}} -\membersection{wxGrid::OnSelectCell}\label{wxgridonselectcell} +Moves the grid cursor down in the current column such that it skips to the beginning or +end of a block of non-empty cells. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. -\func{void}{OnSelectCell}{\param{int}{ row}, \param{int}{ col}} +\wxheading{Keyboard}\\ +This function is called for the Ctrl+Down key combination. Shift+Ctrl+Down expands a selection. -Virtual function called when the user left-clicks on a cell. +\membersection{wxGrid::MoveCursorLeftBlock}\label{wxgridmovecursorleftblock} -\membersection{wxGrid::OnSelectCellImplementation}\label{wxgridonselectcellimplementation} +\func{bool}{MoveCursorLeftBlock}{\param{bool }{expandSelection}} -\func{void}{OnSelectCellImplementation}{\param{wxDC *}{dc}, \param{int}{ row}, \param{int}{ col}} +Moves the grid cursor left in the current row such that it skips to the beginning or +end of a block of non-empty cells. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. -Virtual function called when the user left-clicks on a cell. If you override this function, -call wxGrid::OnSelectCell to apply the default behaviour. +\wxheading{Keyboard}\\ +This function is called for the Ctrl+Left key combination. Shift+Ctrl+left expands a selection. + +\membersection{wxGrid::MoveCursorRightBlock}\label{wxgridmovecursorrightblock} + +\func{bool}{MoveCursorRightBlock}{\param{bool }{expandSelection}} + +Moves the grid cursor right in the current row such that it skips to the beginning or +end of a block of non-empty cells. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. + +\wxheading{Keyboard}\\ +This function is called for the Ctrl+Right key combination. Shift+Ctrl+Right expands a selection. + +\membersection{wxGrid::MoveCursorUpBlock}\label{wxgridmovecursorupblock} + +\func{bool}{MoveCursorUpBlock}{\param{bool }{expandSelection}} + +Moves the grid cursor up in the current column such that it skips to the beginning or +end of a block of non-empty cells. If a block of cells was previously selected it +will expand if the argument is true or be cleared if the argument is false. + +\wxheading{Keyboard}\\ +This function is called for the Ctrl+Up key combination. Shift+Ctrl+Up expands a selection. + +\membersection{wxGrid::MovePageDown}\label{wxgridmovepagedown} + +\func{bool}{MovePageDown}{\void} + +Moves the grid cursor down by some number of rows so that the previous bottom visible row +becomes the top visible row. + +\wxheading{Keyboard}\\ +This function is called for PgDn keypresses. + +\membersection{wxGrid::MovePageUp}\label{wxgridmovepageup} + +\func{bool}{MovePageUp}{\void} + +Moves the grid cursor up by some number of rows so that the previous top visible row +becomes the bottom visible row. + +\wxheading{Keyboard}\\ +This function is called for PgUp keypresses. + +\membersection{wxGrid::SaveEditControlValue}\label{wxgridsaveeditcontrolvalue} + +\func{void}{SaveEditControlValue}{\void} + +Sets the value of the current grid cell to the current in-place edit control value. +This is called automatically when the grid cursor moves from the current cell to a +new cell. It is also a good idea to call this function when closing a grid since +any edits to the final cell location will not be saved otherwise. + +\membersection{wxGrid::SelectAll}\label{wxgridselectall} + +\func{void}{SelectAll}{\void} + +Selects all cells in the grid. + +\membersection{wxGrid::SelectBlock}\label{wxgridselectblock} + +\func{void}{SelectBlock}{\param{int }{topRow}, \param{int }{leftCol}, +\param{int }{bottomRow}, \param{int }{rightCol}, \param{bool }{addToSelected = false}} + +\func{void}{SelectBlock}{\param{const wxGridCellCoords\& }{topLeft}, +\param{const wxGridCellCoords\& }{bottomRight}, \param{bool }{addToSelected = false}} + +Selects a rectangular block of cells. If addToSelected is false then any existing selection will be +deselected; if true the column will be added to the existing selection. + +\membersection{wxGrid::SelectCol}\label{wxgridselectcol} + +\func{void}{SelectCol}{\param{int }{col}, \param{bool }{addToSelected = false}} + +Selects the specified column. If addToSelected is false then any existing selection will be +deselected; if true the column will be added to the existing selection. + +\membersection{wxGrid::SelectRow}\label{wxgridselectrow} + +\func{void}{SelectRow}{\param{int }{row}, \param{bool }{addToSelected = false}} + +Selects the specified row. If addToSelected is false then any existing selection will be +deselected; if true the row will be added to the existing selection. \membersection{wxGrid::SetCellAlignment}\label{wxgridsetcellalignment} -\func{void}{SetCellAlignment}{\param{int}{ alignment}, \param{int}{ row}, \param{int}{ col}} +\func{void}{SetCellAlignment}{\param{int }{row}, \param{int }{col}, \param{int }{horiz}, \param{int }{vert}} -\func{void}{SetCellAlignment}{\param{int}{ alignment}} +\func{void}{SetCellAlignment}{\param{int }{align}, \param{int }{row}, \param{int }{col}} -Sets the text alignment for the cell at the given position, or for the whole grid. {\it alignment} may be wxLEFT, wxRIGHT or wxCENTRE. +\func{void}{SetCellAlignment}{\param{int }{align}} -\membersection{wxGrid::SetCellBackgroundColour}\label{wxgridsetcellbackgroundcolour} +Sets the horizontal and vertical alignment for grid cell text at the specified location. -\func{void}{SetCellBackgroundColour}{\param{const wxColour\&}{ colour}, \param{int}{ row}, \param{int}{ col}} +Horizontal alignment should be one of wxALIGN\_LEFT, wxALIGN\_CENTRE or wxALIGN\_RIGHT. \\ +Vertical alignment should be one of wxALIGN\_TOP, wxALIGN\_CENTRE or wxALIGN\_BOTTOM. -\func{void}{SetCellBackgroundColour}{\param{const wxColour\&}{ colour}} +\membersection{wxGrid::SetCellEditor}\label{wxgridsetcelleditor} -Sets the background colour for the cell at the given position, or for the whole grid. +\func{void}{SetCellEditor}{\param{int }{row}, \param{int }{col}, \param{wxGridCellEditor* }{editor}} -\membersection{wxGrid::SetCellTextColour}\label{wxgridsetcelltextcolour} +Sets the editor for the grid cell at the specified location. +The grid will take ownership of the pointer. -\func{void}{SetCellTextColour}{\param{const wxColour\&}{ colour}, \param{int}{ row}, \param{int}{ col}} +See \helpref{wxGridCellEditor}{wxgridcelleditor} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. -\func{void}{SetCellTextColour}{\param{const wxColour\&}{ colour}} +\membersection{wxGrid::SetCellFont}\label{wxgridsetcellfont} -Sets the text colour for the cell at the given position, or for the whole grid. +\func{void}{SetCellFont}{\param{int }{row}, \param{int }{col}, \param{const wxFont\&}{ font}} -\membersection{wxGrid::SetCellTextFont}\label{wxgridsetcelltextfont} +Sets the font for text in the grid cell at the specified location. + +\membersection{wxGrid::SetCellRenderer}\label{wxgridsetcellrenderer} + +\func{void}{SetCellRenderer}{\param{int }{row}, \param{int }{col}, \param{wxGridCellRenderer* }{renderer}} + +Sets the renderer for the grid cell at the specified location. +The grid will take ownership of the pointer. + +See \helpref{wxGridCellRenderer}{wxgridcellrenderer} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. + +\membersection{wxGrid::SetCellTextColour}\label{wxgridsetcelltextcolour} + +\func{void}{SetCellTextColour}{\param{int }{row}, \param{int }{col}, \param{const wxColour\&}{ colour}} -\func{void}{SetCellTextFont}{\param{wxFont *}{font}, \param{int}{ row}, \param{int}{ col}} +\func{void}{SetCellTextColour}{\param{const wxColour\& }{val}, \param{int }{row}, \param{int }{col}} -\func{void}{SetCellTextFont}{\param{wxFont *}{font}} +\func{void}{SetCellTextColour}{\param{const wxColour\& }{colour}} -Sets the text font for the cell at the given position, or for the whole grid. +Sets the text colour for the grid cell at the specified location. \membersection{wxGrid::SetCellValue}\label{wxgridsetcellvalue} -\func{void}{SetCellValue}{\param{const wxString\&}{ val}, \param{int}{ row}, \param{int}{ col}} +\func{void}{SetCellValue}{\param{int }{row}, \param{int }{col}, \param{const wxString\& }{s}} -Sets the cell value at the given position. +\func{void}{SetCellValue}{\param{const wxGridCellCoords\& }{coords}, \param{const wxString\& }{s}} -\membersection{wxGrid::SetColumnWidth}\label{wxgridsetcolumnwidth} +\func{void}{SetCellValue}{\param{const wxString\& }{val}, \param{int }{row}, \param{int }{col}} -\func{void}{SetColumnWidth}{\param{int}{ col}, \param{int}{ width}} +Sets the string value for the cell at the specified location. For simple applications where a +grid object automatically uses a default grid table of string values you use this function together +with \helpref{wxGrid::GetCellValue}{wxgridgetcellvalue} to access cell values. -Sets the width in pixels for column {\it col}. +For more complex applications where you have derived your own grid table class that contains +various data types (e.g. numeric, boolean or user-defined custom types) then you only use this +function for those cells that contain string values. -\membersection{wxGrid::SetDividerPen}\label{wxgridsetdividerpen} +The last form is for backward compatibility only. -\func{void}{SetDividerPen}{\param{wxPen *}{pen}} +See \helpref{wxGridTableBase::CanSetValueAs}{wxgridtablebasecangetvalueas} +and the \helpref{wxGrid overview}{gridoverview} for more information. -Specifies the pen to be used for drawing the divisions between cells. The default -is a light grey. If NULL is specified, the divisions will not be drawn. +\membersection{wxGrid::SetColAttr}\label{wxgridsetcolattr} -\membersection{wxGrid::SetEditable}\label{wxgridseteditable} +\func{void}{SetColAttr}{\param{int }{col}, \param{wxGridCellAttr* }{attr}} -\func{void}{SetEditable}{\param{bool}{ editable}} +Sets the cell attributes for all cells in the specified column. -If {\it editable} is TRUE (the default), the grid cells will be editable by means of the -text edit control. If FALSE, the text edit control will be hidden and the user will not -be able to edit the cell contents. +For more information about controlling grid cell attributes see the +\helpref{wxGridCellAttr}{wxgridcellattr} cell attribute class and the +\helpref{wxGrid classes overview}{gridoverview}. -\membersection{wxGrid::SetGridCursor}\label{wxgridsetgridcursor} +\membersection{wxGrid::SetColFormatBool}\label{wxgridsetcolformatbool} -\func{void}{SetGridCursor}{\param{int }{row}, \param{int}{ col}} +\func{void}{SetColFormatBool}{\param{int }{col}} -Sets the position of the selected cell. +Sets the specified column to display boolean values. wxGrid displays boolean values with a checkbox. -\membersection{wxGrid::SetLabelAlignment}\label{wxgridsetlabelalignment} +\membersection{wxGrid::SetColFormatNumber}\label{wxgridsetcolformatnumber} -\func{void}{SetLabelAlignment}{\param{int}{ orientation}, \param{int}{ alignment}} +\func{void}{SetColFormatNumber}{\param{int }{col}} -Sets the row or column label alignment. {\it orientation} should -be wxHORIZONTAL to specify column label, wxVERTICAL to specify row label.\rtfsp -{\it alignment} should be wxCENTRE, wxLEFT or wxRIGHT. +Sets the specified column to display integer values. -\membersection{wxGrid::SetLabelBackgroundColour}\label{wxgridsetlabelbackgroundcolour} +\membersection{wxGrid::SetColFormatFloat}\label{wxgridsetcolformatfloat} -\func{void}{SetLabelBackgroundColour}{\param{const wxColour\&}{ value}} +\func{void}{SetColFormatFloat}{\param{int }{col}, \param{int }{width = -1}, \param{int }{precision = -1}} -Sets a row or column label background colour. +Sets the specified column to display floating point values with the given width and precision. -\membersection{wxGrid::SetLabelSize}\label{wxgridsetlabelsize} +\membersection{wxGrid::SetColFormatCustom}\label{wxgridsetcolformatcustom} -\func{void}{SetLabelSize}{\param{int}{ orientation}, \param{int}{ size}} +\func{void}{SetColFormatCustom}{\param{int }{col}, \param{const wxString\& }{typeName}} -Sets the row label height, or column label width, in pixels. {\it orientation} should -be wxHORIZONTAL to specify column label, wxVERTICAL to specify row label. +Sets the specified column to display data in a custom format. +See the \helpref{wxGrid overview}{gridoverview} for more information on working +with custom data types. -If a dimension of zero is specified, the row or column labels will not be -shown. +\membersection{wxGrid::SetColLabelAlignment}\label{wxgridsetcollabelalignment} -\membersection{wxGrid::SetLabelTextColour}\label{wxgridsetlabeltextcolour} +\func{void}{SetColLabelAlignment}{\param{int }{horiz}, \param{int }{vert}} -\func{void}{SetLabelTextColour}{\param{const wxColour\&}{ value}} +Sets the horizontal and vertical alignment of column label text. -Sets a row and column label text colour. +Horizontal alignment should be one of wxALIGN\_LEFT, wxALIGN\_CENTRE or wxALIGN\_RIGHT. -\membersection{wxGrid::SetLabelTextFont}\label{wxgridsetlabeltextfont} +Vertical alignment should be one of wxALIGN\_TOP, wxALIGN\_CENTRE or wxALIGN\_BOTTOM. -\func{void}{SetLabelTextFont}{\param{wxFont *}{font}} +\membersection{wxGrid::SetColLabelSize}\label{wxgridsetcollabelsize} -Sets the font to be used for the row and column labels. +\func{void}{SetColLabelSize}{\param{int }{height}} -\membersection{wxGrid::SetLabelValue}\label{wxgridsetlabelvalue} +Sets the height of the column labels. -\func{void}{SetLabelValue}{\param{int}{ orientation}, \param{const wxString\&}{ value}, \param{int}{ pos}} +\membersection{wxGrid::SetColLabelValue}\label{wxgridsetcollabelvalue} -Sets a row or column label value. {\it orientation} should -be wxHORIZONTAL to specify column label, wxVERTICAL to specify row label.\rtfsp -{\it pos} is the label position. +\func{void}{SetColLabelValue}{\param{int }{col}, \param{const wxString\&}{ value}} -\membersection{wxGrid::SetRowHeight}\label{wxgridsetrowheight} +Set the value for the given column label. If you are using a derived grid table you must +override \helpref{wxGridTableBase::SetColLabelValue}{wxgridtablebasesetcollabelvalue} +for this to have any effect. -\func{void}{SetRowHeight}{\param{int}{ row}, \param{int}{ height}} +\membersection{wxGrid::SetColMinimalWidth}\label{wxgridsetcolminimalwidth} -Sets the height in pixels for row {\it row}. +\func{void}{SetColMinimalWidth}{\param{int }{col}, \param{int }{width}} -\membersection{wxGrid::UpdateDimensions}\label{wxgridupdatedimensions} +Sets the minimal width for the specified column. This should normally be called when creating the grid +because it will not resize a column that is already narrower than the minimal width. +The width argument must be higher than the minimimal acceptable column width, see +\helpref{wxGrid::GetColMinimalAcceptableWidth}{wxgridgetcolminimalacceptablewidth}. -\func{void}{UpdateDimensions}{\void} +\membersection{wxGrid::SetColMinimalAcceptableWidth}\label{wxgridsetcolminimalacceptablewidth} + +\func{void}{SetColMinimalAcceptableWidth}{\param{int }{width}} + +This modifies the minimum column width that can be handled correctly. Specifying a low value here +allows smaller grid cells to be dealt with correctly. Specifying a value here which is much smaller +than the actual minimum size will incur a performance penalty in the functions which perform +grid cell index lookup on the basis of screen coordinates. +This should normally be called when creating the grid because it will not resize existing columns +with sizes smaller than the value specified here. + +\membersection{wxGrid::GetColMinimalAcceptableWidth}\label{wxgridgetcolminimalacceptablewidth} + +\func{int}{GetColMinimalAcceptableWidth}{} + +This returns the value of the lowest column width that can be handled correctly. See +member \helpref{SetColMinimalAcceptableWidth}{wxgridsetcolminimalacceptablewidth} for details. + +\membersection{wxGrid::SetColSize}\label{wxgridsetcolsize} + +\func{void}{SetColSize}{\param{int }{col}, \param{int }{width}} + +Sets the width of the specified column. + +This function does not refresh the grid. If you are calling it outside of a BeginBatch / EndBatch +block you can use \helpref{wxGrid::ForceRefresh}{wxgridforcerefresh} to see the changes. + +Automatically sizes the column to fit its contents. If setAsMin is true the calculated width will +also be set as the minimal width for the column. + +\wxheading{Note}\\ +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. + +\membersection{wxGrid::SetDefaultCellAlignment}\label{wxgridsetdefaultcellalignment} + +\func{void}{SetDefaultCellAlignment}{\param{int }{horiz}, \param{int }{vert}} + +Sets the default horizontal and vertical alignment for grid cell text. + +Horizontal alignment should be one of wxALIGN\_LEFT, wxALIGN\_CENTRE or wxALIGN\_RIGHT. + +Vertical alignment should be one of wxALIGN\_TOP, wxALIGN\_CENTRE or wxALIGN\_BOTTOM. + +\membersection{wxGrid::SetDefaultCellBackgroundColour}\label{wxgridsetdefaultcellbackgroundcolour} + +\func{void}{SetDefaultCellBackgroundColour}{\param{const wxColour\&}{ colour}} + +Sets the default background colour for grid cells. + +\membersection{wxGrid::SetDefaultCellFont}\label{wxgridsetdefaultcellfont} + +\func{void}{SetDefaultCellFont}{\param{const wxFont\&}{ font}} + +Sets the default font to be used for grid cell text. + +\membersection{wxGrid::SetDefaultEditor}\label{wxgridsetdefaulteditor} + +\func{void}{SetDefaultEditor}{\param{wxGridCellEditor* }{editor}} + +Sets the default editor for grid cells. The grid will take ownership of the pointer. + +See \helpref{wxGridCellEditor}{wxgridcelleditor} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. + +\membersection{wxGrid::SetDefaultRenderer}\label{wxgridsetdefaultrenderer} + +\func{void}{SetDefaultRenderer}{\param{wxGridCellRenderer* }{renderer}} + +Sets the default renderer for grid cells. The grid will take ownership of the pointer. + +See \helpref{wxGridCellRenderer}{wxgridcellrenderer} and +the \helpref{wxGrid overview}{gridoverview} for more information about cell editors and renderers. + +\membersection{wxGrid::SetDefaultColSize}\label{wxgridsetdefaultcolsize} + +\func{void}{SetDefaultColSize}{\param{int }{width}, \param{bool }{resizeExistingCols = false}} + +Sets the default width for columns in the grid. This will only affect columns subsequently added to +the grid unless resizeExistingCols is true. + +\membersection{wxGrid::SetDefaultRowSize}\label{wxgridsetdefaultrowsize} + +\func{void}{SetDefaultRowSize}{\param{int }{height}, \param{bool }{resizeExistingRows = false}} + +Sets the default height for rows in the grid. This will only affect rows subsequently added +to the grid unless resizeExistingRows is true. + +\membersection{wxGrid::SetGridCursor}\label{wxgridsetgridcursor} + +\func{void}{SetGridCursor}{\param{int }{row}, \param{int }{col}} + +Set the grid cursor to the specified cell. +This function calls \helpref{wxGrid::MakeCellVisible}{wxgridmakecellvisible}. + +\membersection{wxGrid::SetGridLineColour}\label{wxgridsetgridlinecolour} + +\func{void}{SetGridLineColour}{\param{const wxColour\&}{colour}} + +Sets the colour used to draw grid lines. + +\membersection{wxGrid::SetLabelBackgroundColour}\label{wxgridsetlabelbackgroundcolour} + +\func{void}{SetLabelBackgroundColour}{\param{const wxColour\&}{ colour}} + +Sets the background colour for row and column labels. + +\membersection{wxGrid::SetLabelFont}\label{wxgridsetlabelfont} + +\func{void}{SetLabelFont}{\param{const wxFont\&}{ font}} + +Sets the font for row and column labels. + +\membersection{wxGrid::SetLabelTextColour}\label{wxgridsetlabeltextcolour} + +\func{void}{SetLabelTextColour}{\param{const wxColour\&}{ colour}} + +Sets the colour for row and column label text. + +\membersection{wxGrid::SetReadOnly}\label{wxgridsetreadonly} + +\func{void}{SetReadOnly}{\param{int }{row}, \param{int }{col}, \param{bool }{isReadOnly = true}} + +Makes the cell at the specified location read-only or editable. +See also \helpref{wxGrid::IsReadOnly}{wxgridisreadonly}. + +\membersection{wxGrid::SetRowAttr}\label{wxgridsetrowattr} + +\func{void}{SetRowAttr}{\param{int }{row}, \param{wxGridCellAttr* }{attr}} + +Sets the cell attributes for all cells in the specified row. +See the \helpref{wxGridCellAttr}{wxgridcellattr} class for more information +about controlling cell attributes. + +\membersection{wxGrid::SetRowLabelAlignment}\label{wxgridsetrowlabelalignment} + +\func{void}{SetRowLabelAlignment}{\param{int }{horiz}, \param{int }{vert}} + +Sets the horizontal and vertical alignment of row label text. + +Horizontal alignment should be one of wxALIGN\_LEFT, wxALIGN\_CENTRE or wxALIGN\_RIGHT. + +Vertical alignment should be one of wxALIGN\_TOP, wxALIGN\_CENTRE or wxALIGN\_BOTTOM. + +\membersection{wxGrid::SetRowLabelSize}\label{wxgridsetrowlabelsize} + +\func{void}{SetRowLabelSize}{\param{int }{width}} + +Sets the width of the row labels. + +\membersection{wxGrid::SetRowLabelValue}\label{wxgridsetrowlabelvalue} + +\func{void}{SetRowLabelValue}{\param{int }{row}, \param{const wxString\&}{ value}} + +Set the value for the given row label. If you are using a derived grid table you must +override \helpref{wxGridTableBase::SetRowLabelValue}{wxgridtablebasesetrowlabelvalue} +for this to have any effect. + +\membersection{wxGrid::SetRowMinimalHeight}\label{wxgridsetrowminimalheight} + +\func{void}{SetRowMinimalHeight}{\param{int }{row}, \param{int }{height}} + +Sets the minimal height for the specified row. This should normally be called when creating the grid +because it will not resize a row that is already shorter than the minimal height. +The height argument must be higher than the minimimal acceptable row height, see +\helpref{wxGrid::GetRowMinimalAcceptableHeight}{wxgridgetrowminimalacceptableheight}. + +\membersection{wxGrid::SetRowMinimalAcceptableHeight}\label{wxgridsetrowminimalacceptableheight} + +\func{void}{SetRowMinimalAcceptableHeight}{\param{int }{height}} + +This modifies the minimum row width that can be handled correctly. Specifying a low value here +allows smaller grid cells to be dealt with correctly. Specifying a value here which is much smaller +than the actual minimum size will incur a performance penalty in the functions which perform +grid cell index lookup on the basis of screen coordinates. +This should normally be called when creating the grid because it will not resize existing rows +with sizes smaller than the value specified here. + +\membersection{wxGrid::GetRowMinimalAcceptableHeight}\label{wxgridgetrowminimalacceptableheight} + +\func{int}{GetRowMinimalAcceptableHeight}{} + +This returns the value of the lowest row width that can be handled correctly. See +member \helpref{SetRowMinimalAcceptableHeight}{wxgridsetrowminimalacceptableheight} for details. + +\membersection{wxGrid::SetRowSize}\label{wxgridsetrowsize} + +\func{void}{SetRowSize}{\param{int }{row}, \param{int }{height}} + +Sets the height of the specified row. + +This function does not refresh the grid. If you are calling it outside of a BeginBatch / EndBatch +block you can use \helpref{wxGrid::ForceRefresh}{wxgridforcerefresh} to see the changes. + +Automatically sizes the column to fit its contents. If setAsMin is true the calculated width will +also be set as the minimal width for the column. + +\wxheading{Note} + +wxGrid sets up arrays to store individual row and column sizes when non-default sizes are used. +The memory requirements for this could become prohibitive if your grid is very large. + +\membersection{wxGrid::SetSelectionMode}\label{wxgridsetselectionmode} + +\func{void}{SetSelectionMode}{\param{wxGrid::wxGridSelectionModes}{ selmode}} + +Set the selection behaviour of the grid. + +\wxheading{Parameters} + +\docparam{wxGrid::wxGridSelectCells}{The default mode where individual cells are selected.} + +\docparam{wxGrid::wxGridSelectRows}{Selections will consist of whole rows.} + +\docparam{wxGrid::wxGridSelectionColumns}{Selections will consist of whole columns.} + +\membersection{wxGrid::SetTable}\label{wxgridsettable} + +\func{bool}{SetTable}{\param{wxGridTableBase* }{table}, \param{bool }{takeOwnership = false}, \param{wxGrid::wxGridSelectionModes }{selmode = wxGrid::wxGridSelectCells}} + +Passes a pointer to a custom grid table to be used by the grid. This should be called +after the grid constructor and before using the grid object. If takeOwnership is set to +true then the table will be deleted by the wxGrid destructor. + +Use this function instead of \helpref{wxGrid::CreateGrid}{wxgridcreategrid} when your +application involves complex or non-string data or data sets that are too large to fit +wholly in memory. + +\membersection{wxGrid::ShowCellEditControl}\label{wxgridshowcelleditcontrol} + +\func{void}{ShowCellEditControl}{\void} + +Displays the in-place cell edit control for the current cell. + +\membersection{wxGrid::XToCol}\label{wxgridxtocol} + +\func{int}{XToCol}{\param{int }{x}} + +Returns the grid column that corresponds to the logical x coordinate. Returns +wxNOT\_FOUND if there is no column at the x position. + +\membersection{wxGrid::XToEdgeOfCol}\label{wxgridxtoedgeofcol} + +\func{int}{XToEdgeOfCol}{\param{int }{x}} + +Returns the column whose right hand edge is close to the given logical x position. +If no column edge is near to this position wxNOT\_FOUND is returned. + +\membersection{wxGrid::YToEdgeOfRow}\label{wxgridytoedgeofrow} + +\func{int}{YToEdgeOfRow}{\param{int }{y}} + +Returns the row whose bottom edge is close to the given logical y position. +If no row edge is near to this position wxNOT\_FOUND is returned. + +\membersection{wxGrid::YToRow}\label{wxgridytorow} + +\func{int}{YToRow}{\param{int }{y}} + +Returns the grid row that corresponds to the logical y coordinate. Returns +wxNOT\_FOUND if there is no row at the y position. + + +\membersection{wxGrid::BlockToDeviceRect}\label{wxgridblocktodevicerect} + +\func{wxRect}{BlockToDeviceRect}{\param{const wxGridCellCoords \& }{topLeft}, \param{const wxGridCellCoords \& }{bottomRight}} + +This function returns the rectangle that encloses the block of cells +limited by TopLeft and BottomRight cell in device coords and clipped +to the client size of the grid window. + + +\membersection{wxGrid::SelectionToDeviceRect}\label{wxgridselectiontodevicerect} + +\func{wxRect}{SelectionToDeviceRect}{\void} + +This function returns the rectangle that encloses the selected cells +in device coords and clipped to the client size of the grid window. + + +\membersection{wxGrid::GetSelectionBackground}\label{wxgridgetselectionbackground} + +\constfunc{wxColour}{GetSelectionBackground}{\void} + +Access or update the selection fore/back colours + + +\membersection{wxGrid::GetSelectionForeground}\label{wxgridgetselectionforeground} + +\constfunc{wxColour}{GetSelectionForeground}{\void} + + +\membersection{wxGrid::SetSelectionBackground}\label{wxgridsetselectionbackground} + +\func{void}{SetSelectionBackground}{\param{const wxColour\& }{c}} + + +\membersection{wxGrid::SetSelectionForeground}\label{wxgridsetselectionforeground} + +\func{void}{SetSelectionForeground}{\param{const wxColour\& }{c}} + + +\membersection{wxGrid::RegisterDataType}\label{wxgridregisterdatatype} + +\func{void}{RegisterDataType}{\param{const wxString\& }{typeName}, \param{wxGridCellRenderer* }{renderer}, \param{wxGridCellEditor* }{editor}} + +Methods for a registry for mapping data types to Renderers/Editors + +\membersection{wxGrid::GetDefaultEditorForCell}\label{wxgridgetdefaulteditorforcell} + +\constfunc{wxGridCellEditor*}{GetDefaultEditorForCell}{\param{int }{row}, \param{int }{col}} + +\constfunc{wxGridCellEditor*}{GetDefaultEditorForCell}{\param{const wxGridCellCoords\& }{c}} + + +\membersection{wxGrid::GetDefaultRendererForCell}\label{wxgridgetdefaultrendererforcell} + +\constfunc{wxGridCellRenderer*}{GetDefaultRendererForCell}{\param{int }{row}, \param{int }{col}} + + +\membersection{wxGrid::GetDefaultEditorForType}\label{wxgridgetdefaulteditorfortype} + +\constfunc{wxGridCellEditor*}{GetDefaultEditorForType}{\param{const wxString\& }{typeName}} + + +\membersection{wxGrid::GetDefaultRendererForType}\label{wxgridgetdefaultrendererfortype} + +\constfunc{wxGridCellRenderer*}{GetDefaultRendererForType}{\param{const wxString\& }{typeName}} + + +\membersection{wxGrid::SetMargins}\label{wxgridsetmargins} + +\func{void}{SetMargins}{\param{int }{extraWidth}, \param{int }{extraHeight}} + +A grid may occupy more space than needed for its rows/columns. This +function allows to set how big this extra space is + +\membersection{wxGrid::wxGrid}\label{wxgridwxgrid} + +\func{}{wxGrid}{\param{wxWindow* }{parent}, \param{int }{x}, \param{int }{y}, \param{int }{w = -1}, \param{int }{h = -1}, \param{long }{style = wxWANTS\_CHARS}, \param{const wxString\& }{name = wxPanelNameStr}} + +Backward compatibility. + +\membersection{wxGrid::UpdateDimensions}\label{wxgridupdatedimensions} + +\func{void}{UpdateDimensions}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetRows}\label{wxgridgetrows} + +\func{int}{GetRows}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetCols}\label{wxgridgetcols} + +\func{int}{GetCols}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetCursorRow}\label{wxgridgetcursorrow} + +\func{int}{GetCursorRow}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetCursorColumn}\label{wxgridgetcursorcolumn} + +\func{int}{GetCursorColumn}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetScrollPosX}\label{wxgridgetscrollposx} + +\func{int}{GetScrollPosX}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetScrollPosY}\label{wxgridgetscrollposy} + +\func{int}{GetScrollPosY}{\void} + +Backward compatibility. + +\membersection{wxGrid::SetScrollX}\label{wxgridsetscrollx} + +\func{void}{SetScrollX}{\param{int }{x}} + +Backward compatibility. + +\membersection{wxGrid::SetScrollY}\label{wxgridsetscrolly} + +\func{void}{SetScrollY}{\param{int }{y}} + +Backward compatibility. + +\membersection{wxGrid::SetColumnWidth}\label{wxgridsetcolumnwidth} + +\func{void}{SetColumnWidth}{\param{int }{col}, \param{int }{width}} + +Backward compatibility. + +\membersection{wxGrid::GetColumnWidth}\label{wxgridgetcolumnwidth} + +\func{int}{GetColumnWidth}{\param{int }{col}} + +Backward compatibility. + +\membersection{wxGrid::SetRowHeight}\label{wxgridsetrowheight} + +\func{void}{SetRowHeight}{\param{int }{row}, \param{int }{height}} + +Backward compatibility. + +\membersection{wxGrid::GetViewHeight}\label{wxgridgetviewheight} + +\func{int}{GetViewHeight}{\void} + +Backward compatibility. + +\membersection{wxGrid::GetViewWidth}\label{wxgridgetviewwidth} + +\func{int}{GetViewWidth}{\void} + +Returned number of whole cols visible. + +\membersection{wxGrid::SetLabelSize}\label{wxgridsetlabelsize} + +\func{void}{SetLabelSize}{\param{int }{orientation}, \param{int }{sz}} + + +\membersection{wxGrid::GetLabelSize}\label{wxgridgetlabelsize} + +\func{int}{GetLabelSize}{\param{int }{orientation}} + + +\membersection{wxGrid::SetLabelAlignment}\label{wxgridsetlabelalignment} + +\func{void}{SetLabelAlignment}{\param{int }{orientation}, \param{int }{align}} + + +\membersection{wxGrid::GetLabelAlignment}\label{wxgridgetlabelalignment} + +\func{int}{GetLabelAlignment}{\param{int }{orientation}, \param{int }{align}} + + +\membersection{wxGrid::SetLabelValue}\label{wxgridsetlabelvalue} + +\func{void}{SetLabelValue}{\param{int }{orientation}, \param{const wxString\& }{val}, \param{int }{pos}} + + +\membersection{wxGrid::GetLabelValue}\label{wxgridgetlabelvalue} + +\func{wxString}{GetLabelValue}{\param{int }{orientation}, \param{int }{pos}} + + +\membersection{wxGrid::GetCellTextFont}\label{wxgridgetcelltextfont} + +\constfunc{wxFont}{GetCellTextFont}{\void} + +\constfunc{wxFont}{GetCellTextFont}{\param{int }{row}, \param{int }{col}} + + +\membersection{wxGrid::SetCellTextFont}\label{wxgridsetcelltextfont} + +\func{void}{SetCellTextFont}{\param{const wxFont\& }{fnt}} + +\func{void}{SetCellTextFont}{\param{const wxFont\& }{fnt}, \param{int }{row}, \param{int }{col}} + + +\membersection{wxGrid::SetCellBackgroundColour}\label{wxgridsetcellbackgroundcolour} + +\func{void}{SetCellBackgroundColour}{\param{const wxColour\& }{col}} + +\func{void}{SetCellBackgroundColour}{\param{int }{row}, \param{int }{col}, \param{const wxColour\&}{ colour}} + +\func{void}{SetCellBackgroundColour}{\param{const wxColour\& }{colour}, \param{int }{row}, \param{int }{col}} + + +\membersection{wxGrid::GetEditable}\label{wxgridgeteditable} + +\func{bool}{GetEditable}{\void} + + +\membersection{wxGrid::SetEditable}\label{wxgridseteditable} + +\func{void}{SetEditable}{\param{bool }{edit = true}} + + +\membersection{wxGrid::GetEditInPlace}\label{wxgridgeteditinplace} + +\func{bool}{GetEditInPlace}{\void} + + +\membersection{wxGrid::SetEditInPlace}\label{wxgridseteditinplace} + +\func{void}{SetEditInPlace}{\param{bool }{edit = true}} + + +\membersection{wxGrid::SetCellBitmap}\label{wxgridsetcellbitmap} + +\func{void}{SetCellBitmap}{\param{wxBitmap* }{bitmap}, \param{int }{row}, \param{int }{col}} + + +\membersection{wxGrid::SetDividerPen}\label{wxgridsetdividerpen} + +\func{void}{SetDividerPen}{\param{const wxPen\& }{pen}} + + +\membersection{wxGrid::GetDividerPen}\label{wxgridgetdividerpen} + +\constfunc{wxPen\&}{GetDividerPen}{\void} + + +\membersection{wxGrid::OnActivate}\label{wxgridonactivate} + +\func{void}{OnActivate}{\param{bool }{active}} + +\membersection{wxGrid::Fit}\label{wxgridfit} + +\func{void}{Fit}{\void} + +Overridden wxWindow methods + +\membersection{wxGrid::DoGetBestSize}\label{wxgriddogetbestsize} + +\constfunc{wxSize}{DoGetBestSize}{\void} + +\membersection{wxGrid::InitRowHeights}\label{wxgridinitrowheights} + +\func{void}{InitRowHeights}{\void} + +NB: {\it never} access m\_row/col arrays directly because they are created +on demand, {\it always} use accessor functions instead! + +Init the m\_rowHeights/Bottoms arrays with default values. + +\membersection{wxGrid::InitColWidths}\label{wxgridinitcolwidths} + +\func{void}{InitColWidths}{\void} + +Init the m\_colWidths/Rights arrays + + +\membersection{wxGrid::GetColWidth}\label{wxgridgetcolwidth} + +\constfunc{int}{GetColWidth}{\param{int }{col}} + +Get the col/row coords + + +\membersection{wxGrid::GetColLeft}\label{wxgridgetcolleft} + +\constfunc{int}{GetColLeft}{\param{int }{col}} + + +\membersection{wxGrid::GetColRight}\label{wxgridgetcolright} + +\constfunc{int}{GetColRight}{\param{int }{col}} + + +\membersection{wxGrid::GetRowHeight}\label{wxgridgetrowheight} + +\constfunc{int}{GetRowHeight}{\param{int }{row}} + +This function must be public for compatibility. + +\membersection{wxGrid::GetRowTop}\label{wxgridgetrowtop} + +\constfunc{int}{GetRowTop}{\param{int }{row}} + + +\membersection{wxGrid::GetRowBottom}\label{wxgridgetrowbottom} + +\constfunc{int}{GetRowBottom}{\param{int }{row}} + + +\membersection{wxGrid::SetOrCalcColumnSizes}\label{wxgridsetorcalccolumnsizes} + +\func{int}{SetOrCalcColumnSizes}{\param{bool }{calcOnly}, \param{bool }{setAsMin = true}} + +Common part of AutoSizeColumn/Row() and GetBestSize() + +\membersection{wxGrid::SetOrCalcRowSizes}\label{wxgridsetorcalcrowsizes} + +\func{int}{SetOrCalcRowSizes}{\param{bool }{calcOnly}, \param{bool }{setAsMin = true}} + +\membersection{wxGrid::AutoSizeColOrRow}\label{wxgridautosizecolorrow} + +\func{void}{AutoSizeColOrRow}{\param{int }{n}, \param{bool }{setAsMin}, \param{bool }{column}} + +Common part of AutoSizeColumn/Row() or row? + +\membersection{wxGrid::GetColMinimalWidth}\label{wxgridgetcolminimalwidth} + +\constfunc{int}{GetColMinimalWidth}{\param{int }{col}} + +get the minimal width of the given column/row + +\membersection{wxGrid::GetRowMinimalHeight}\label{wxgridgetrowminimalheight} + +\constfunc{int}{GetRowMinimalHeight}{\param{int }{col}} + +\membersection{wxGrid::CanHaveAttributes}\label{wxgridcanhaveattributes} + +\func{bool}{CanHaveAttributes}{\void} + +Do we have some place to store attributes in? -Call this function whenever a change has been made via the API that -might alter size characteristics. You may also need to follow it with -a call to AdjustScrollbars. +\membersection{wxGrid::GetOrCreateCellAttr}\label{wxgridgetorcreatecellattr} +\constfunc{wxGridCellAttr*}{GetOrCreateCellAttr}{\param{int }{row}, \param{int }{col}}