]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/gridedit.tex
Always draw the selection of selected items, not just when they have
[wxWidgets.git] / docs / latex / wx / gridedit.tex
index 67a8e7080b3a82c95dc619be10d4254395ceb9dc..7d7826fd16ff96c09c9a2f4ec0b8b9ec2324768b 100644 (file)
 % grid.h at 11/May/00 18:30:18
 %
 
+\section{\class{wxGridCellBoolEditor}}\label{wxgridcellbooleditor}
 
-\section{\class{wxGridCellEditor}}\label{wxgridcelleditor}
+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 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]]"
 
-wxGridCellEditor:  This class is responsible for providing and manipulating
+\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 ABC) can be
+(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}
 
-\helpref{wxGridCellWorker}{wxgridcellworker}
+wxGridCellWorker
 
-\wxheading{Data structures}
+\wxheading{See also}
 
-\latexignore{\rtfignore{\wxheading{Members}}}
+\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
-
+Creates the actual edit control.
 
 \membersection{wxGridCellEditor::SetSize}\label{wxgridcelleditorsetsize}
 
 \func{void}{SetSize}{\param{const wxRect\& }{rect}}
 
-Size and position the edit control
-
+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
-
+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
-
+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.
-
+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.
-
+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
-
+Reset the value in the control back to its starting value.
 
 \membersection{wxGridCellEditor::StartingKey}\label{wxgridcelleditorstartingkey}
 
@@ -95,14 +177,12 @@ 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
-
+If the editor is enabled by clicking on the cell, this method will be
+called.
 
 \membersection{wxGridCellEditor::HandleReturn}\label{wxgridcelleditorhandlereturn}
 
@@ -111,24 +191,150 @@ called
 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
-
+Final cleanup.
 
 \membersection{wxGridCellEditor::Clone}\label{wxgridcelleditorclone}
 
 \constfunc{wxGridCellEditor*}{Clone}{\void}
 
-create a new object which is the copy of this one
-
+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
+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.
+