Moved include for Windows compilation; minor doc tweaks

[wxWidgets.git] / docs / latex / wx / gridedit.tex

%
% automatically generated by HelpGen from
% grid.h at 11/May/00 18:30:18
%

\section{\class{wxGridCellEditor}}\label{wxgridcelleditor}

This class is responsible for providing and manipulating
the in-place edit controls for the grid.  Instances of wxGridCellEditor
(actually, instances of derived classes since it is an abstract class) can be
associated with the cell attributes for individual cells, rows, columns, or
even for the entire grid.

\wxheading{Derived from}

wxGridCellWorker

\wxheading{See also}

\helpref{wxGridCellTextEditor}{wxgridcelltexteditor},\rtfsp
\helpref{wxGridCellFloatEditor}{wxgridcellfloateditor},\rtfsp
\helpref{wxGridCellBoolEditor}{wxgridcellbooleditor},\rtfsp
\helpref{wxGridCellNumberEditor}{wxgridcellnumbereditor},\rtfsp
\helpref{wxGridCellChoiceEditor}{wxgridcellchoiceeditor}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxGridCellEditor::wxGridCellEditor}\label{wxgridcelleditorwxgridcelleditor}

\func{}{wxGridCellEditor}{\void}

\membersection{wxGridCellEditor::IsCreated}\label{wxgridcelleditoriscreated}

\func{bool}{IsCreated}{\void}

\membersection{wxGridCellEditor::Create}\label{wxgridcelleditorcreate}

\func{void}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{wxEvtHandler* }{evtHandler}}

Creates the actual edit control.

\membersection{wxGridCellEditor::SetSize}\label{wxgridcelleditorsetsize}

\func{void}{SetSize}{\param{const wxRect\& }{rect}}

Size and position the edit control.

\membersection{wxGridCellEditor::Show}\label{wxgridcelleditorshow}

\func{void}{Show}{\param{bool }{show}, \param{wxGridCellAttr* }{attr = NULL}}

Show or hide the edit control, use the specified attributes to set
colours/fonts for it.

\membersection{wxGridCellEditor::PaintBackground}\label{wxgridcelleditorpaintbackground}

\func{void}{PaintBackground}{\param{const wxRect\& }{rectCell}, \param{wxGridCellAttr* }{attr}}

Draws the part of the cell not occupied by the control: the base class
version just fills it with background colour from the attribute.

\membersection{wxGridCellEditor::BeginEdit}\label{wxgridcelleditorbeginedit}

\func{void}{BeginEdit}{\param{int }{row}, \param{int }{col}, \param{wxGrid* }{grid}}

Fetch the value from the table and prepare the edit control
to begin editing. Set the focus to the edit control.

\membersection{wxGridCellEditor::EndEdit}\label{wxgridcelleditorendedit}

\func{bool}{EndEdit}{\param{int }{row}, \param{int }{col}, \param{wxGrid* }{grid}}

Complete the editing of the current cell. Returns true if the value has
changed. If necessary, the control may be destroyed.

\membersection{wxGridCellEditor::Reset}\label{wxgridcelleditorreset}

\func{void}{Reset}{\void}

Reset the value in the control back to its starting value.

\membersection{wxGridCellEditor::StartingKey}\label{wxgridcelleditorstartingkey}

\func{void}{StartingKey}{\param{wxKeyEvent\& }{event}}

If the editor is enabled by pressing keys on the grid,
this will be called to let the editor do something about
that first key if desired.

\membersection{wxGridCellEditor::StartingClick}\label{wxgridcelleditorstartingclick}

\func{void}{StartingClick}{\void}

If the editor is enabled by clicking on the cell, this method will be
called.

\membersection{wxGridCellEditor::HandleReturn}\label{wxgridcelleditorhandlereturn}

\func{void}{HandleReturn}{\param{wxKeyEvent\& }{event}}

Some types of controls on some platforms may need some help
with the Return key.

\membersection{wxGridCellEditor::Destroy}\label{wxgridcelleditordestroy}

\func{void}{Destroy}{\void}

Final cleanup.

\membersection{wxGridCellEditor::Clone}\label{wxgridcelleditorclone}

\constfunc{wxGridCellEditor*}{Clone}{\void}

Create a new object which is the copy of this one.

\membersection{wxGridCellEditor::\destruct{wxGridCellEditor}}\label{wxgridcelleditordtor}

\func{}{\destruct{wxGridCellEditor}}{\void}

The dtor is private because only DecRef() can delete us.


\section{\class{wxGridCellTextEditor}}\label{wxgridcelltexteditor}

The editor for string/text data.

\wxheading{Derived from}

\helpref{wxGridCellEditor}{wxgridcelleditor}

\wxheading{See also}

\helpref{wxGridCellEditor}{wxgridcelleditor},\rtfsp
\helpref{wxGridCellFloatEditor}{wxgridcellfloateditor},\rtfsp
\helpref{wxGridCellBoolEditor}{wxgridcellbooleditor},\rtfsp
\helpref{wxGridCellNumberEditor}{wxgridcellnumbereditor},\rtfsp
\helpref{wxGridCellChoiceEditor}{wxgridcellchoiceeditor}

\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxGridCellTextEditor::wxGridCellTextEditor}\label{wxgridcelltexteditorconstr}

\func{}{wxGridCellTextEditor}{\void}

Default constructor.

\membersection{wxGridCellTextEditor::SetParameters}\label{wxgridcelltexteditorsetparameters}

\func{void}{SetParameters}{\param{const wxString\& }{params}}

The parameters string format is "n" where n is a number representing the maximum width.


\section{\class{wxGridCellNumberEditor}}\label{wxgridcellnumbereditor}

The editor for numeric integer data.

\wxheading{Derived from}

\helpref{wxGridCellTextEditor}{wxgridcelltexteditor}\\
\helpref{wxGridCellEditor}{wxgridcelleditor}

\wxheading{See also}

\helpref{wxGridCellEditor}{wxgridcelleditor},\rtfsp
\helpref{wxGridCellFloatEditor}{wxgridcellfloateditor},\rtfsp
\helpref{wxGridCellBoolEditor}{wxgridcellbooleditor},\rtfsp
\helpref{wxGridCellTextEditor}{wxgridcelltexteditor},\rtfsp
\helpref{wxGridCellChoiceEditor}{wxgridcellchoiceeditor}


\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxGridCellNumberEditor::wxGridCellNumberEditor}\label{wxgridcellnumbereditorconstr}

\func{}{wxGridCellNumberEditor}{\param{int }{min = -1}, \param{int }{max = -1}}

Allows to specify the range for acceptable data;
if min == max == -1, no range checking is done


\membersection{wxGridCellNumberEditor::GetString}\label{wxgridcellnumbereditorgetstring}

\constfunc{wxString}{GetString}{\void}

String representation of the value.


\membersection{wxGridCellNumberEditor::HasRange}\label{wxgridcellnumbereditorhasrange}

\constfunc{bool}{HasRange}{\void}

If the return value is true, the editor uses a wxSpinCtrl to get user input,
otherwise it uses a wxTextCtrl.


\membersection{wxGridCellNumberEditor::SetParameters}\label{wxgridcellnumbereditorsetparameters}

\func{void}{SetParameters}{\param{const wxString\& }{params}}

Parameters string format is "min,max".


\section{\class{wxGridCellFloatEditor}}\label{wxgridcellfloateditor}

The editor for floating point numbers data.

\wxheading{Derived from}

\helpref{wxGridCellTextEditor}{wxgridcelltexteditor}\\
\helpref{wxGridCellEditor}{wxgridcelleditor}

\wxheading{See also}

\helpref{wxGridCellEditor}{wxgridcelleditor},\rtfsp
\helpref{wxGridCellNumberEditor}{wxgridcellnumbereditor},\rtfsp
\helpref{wxGridCellBoolEditor}{wxgridcellbooleditor},\rtfsp
\helpref{wxGridCellTextEditor}{wxgridcelltexteditor},\rtfsp
\helpref{wxGridCellChoiceEditor}{wxgridcellchoiceeditor}


\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxGridCellFloatEditor::wxGridCellFloatEditor}\label{wxgridcellfloateditorconstr}

\func{}{wxGridCellFloatEditor}{\param{int }{width = -1}, \param{int }{precision = -1}}

\docparam{width}{Minimum number of characters to be shown.}
\docparam{precision}{Number of digits after the decimal dot.}


\membersection{wxGridCellFloatEditor::SetParameters}\label{wxgridcellfloateditorsetparameters}

\func{void}{SetParameters}{\param{const wxString\& }{params}}

Parameters string format is "width,precision"


\section{\class{wxGridCellBoolEditor}}\label{wxgridcellbooleditor}

The editor for boolean data.

\wxheading{Derived from}

\helpref{wxGridCellEditor}{wxgridcelleditor}

\wxheading{See also}

\helpref{wxGridCellEditor}{wxgridcelleditor},\rtfsp
\helpref{wxGridCellFloatEditor}{wxgridcellfloateditor},\rtfsp
\helpref{wxGridCellNumberEditor}{wxgridcellnumbereditor},\rtfsp
\helpref{wxGridCellTextEditor}{wxgridcelltexteditor},\rtfsp
\helpref{wxGridCellChoiceEditor}{wxgridcellchoiceeditor}

\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxGridCellBoolEditor::wxGridCellBoolEditor}\label{wxgridcellbooleditorconstr}

\func{}{wxGridCellBoolEditor}{}

Default constructor.


\section{\class{wxGridCellChoiceEditor}}\label{wxgridcellchoiceeditor}

The editor for string data allowing to choose from a list of strings.

\wxheading{Derived from}

\helpref{wxGridCellEditor}{wxgridcelleditor}

\wxheading{See also}

\helpref{wxGridCellEditor}{wxgridcelleditor},\rtfsp
\helpref{wxGridCellFloatEditor}{wxgridcellfloateditor},\rtfsp
\helpref{wxGridCellBoolEditor}{wxgridcellbooleditor},\rtfsp
\helpref{wxGridCellTextEditor}{wxgridcelltexteditor},\rtfsp
\helpref{wxGridCellNumberEditor}{wxgridcellnumbereditor}


\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxGridCellChoiceEditor::wxGridCellChoiceEditor}\label{wxgridcellchoiceeditorconstr}

\func{}{wxGridCellChoiceEditor}{\param{size\_t }{count = 0}, \param{const wxString }{choices[] = NULL}, \param{bool }{allowOthers = FALSE}}

\docparam{count}{Number of strings from which the user can choose.}
\docparam{choices}{An array of strings from which the user can choose.}
\docparam{allowOthers}{If allowOthers if TRUE, the user can type a string not in choices array.}


\membersection{wxGridCellChoiceEditor::SetParameters}\label{wxgridcellchoiceeditorsetparameters}

\func{void}{SetParameters}{\param{const wxString\& }{params}}

Parameters string format is "item1[,item2[...,itemN]]"