don't make read-only text controls editable when enabled

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

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

\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}

\wxheading{Include files}

<wx/grid.h>

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


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

\func{}{wxGridCellBoolEditor}{}

Default constructor.


\membersection{wxGridCellBoolEditor::IsTrueValue}\label{wxgridcellbooleditoristruevalue}

\func{static bool}{IsTrueValue}{\param{const wxString\& }{value}}

Returns \true if the given \arg{value} is equal to the string representation of
the truth value we currently use (see 
\helpref{UseStringValues}{wxgridcellbooleditorusestringvalues}).


\membersection{wxGridCellBoolEditor::UseStringValues}\label{wxgridcellbooleditorusestringvalues}

\func{static void}{UseStringValues}{\param{const wxString\& }{valueTrue = \_T("1")}, \param{const wxString\& }{valueFalse = \_T("")}}

This method allows to customize the values returned by GetValue() method for
the cell using this editor. By default, the default values of the arguments are
used, i.e. \texttt{"1"} is returned if the cell is checked and an empty string
otherwise, using this method allows to change this.


\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}}

\func{}{wxGridCellChoiceEditor}{\param{const wxArrayString\& }{choices}, \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 is 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]]"

\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}

\wxheading{Include files}

<wx/grid.h>

\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{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}

\wxheading{Include files}

<wx/grid.h>

\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{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}

\wxheading{Include files}

<wx/grid.h>

\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{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}

\wxheading{Include files}

<wx/grid.h>

\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.