The
invocationEdit
event handler is a special user-defined
Function
that can be added to a
JTable
when it is created
and that will be called automatically with a single
InvocationEvent
argument whenever a
JTable
cell has been edited so that its new value differs from its old value.
Note: for cell edit validation purposes, it is recommend to use the
validator
function in
JTable
rather than this event handler.
An
invocationEdit
event handler can only be added via
addEventHandler
after a component is created,
but an existing
invocationEdit
event handler can be assigned new values.
Assigning
NULL
to
invocationEdit
disables its functionality until a
NULL
value is assigned to it.
The
InvocationEvent
received by this handler will have the following fields:
| etc |
A field that is not currently used and may not be defined,
but it should be considered reserved for releases.
| | id |
An
Object
that must be an
int
or
String,
that identifies the type of this event.
A value that is a
String
must be the name of an event handler that can process this event.
A value that is an
int
must be a number that the
yoix.event.HandlerID
dictionary associates with an event handler that can process this event.
In practice,
id
is only used when you build an event that gets handed to
postEvent,
and in that case the value assigned to
id
is almost always a
String.
| | oldtext |
The text value of the cell prior to the editing change.
The text value is the
String
representation of the data underlying the cell (see below).
| | oldvalue |
The value of the cell prior to the editing change.
The value is the
Object
representation of the data underlying the cell (see below).
| | oldview |
The text view of the cell prior to the editing change.
The text view is the
String
representation of the data underlying the cell as it is displayed in
the cell (see below).
| | text |
The text value of the cell after to the editing change.
The text value is the
String
representation of the data underlying the cell (see below).
| | value |
The value of the cell after to the editing change.
The value is the
Object
representation of the data underlying the cell (see below).
| | valuesColumn |
An
int
that is the column location where the cell editing occurred in terms
of the column's position in the values matrix.
| | valuesRow |
An
int
that is the row location where the cell editing occurred in terms
of the row's position in the values matrix.
| | view |
The text view of the cell after to the editing change.
The text view is the
String
representation of the data underlying the cell as it is displayed in
the cell (see below).
| | viewColumn |
An
int
that is the column location where the cell editing occurred in terms
of the column's position in the view matrix.
| | viewRow |
An
int
that is the row location where the cell editing occurred in terms
of the row's position in the view matrix.
|
To clarify the difference between
text,
value
and
view
representations of a cell, consider a column that display money values in USD and say
that a particular cell contains the number
123.123.
That
double
value would be the
value
representation, while the text representation would be the
String
123.123
and the view representation would be the
String
$123.12.
| |
| Return: |
none
| | |
| See Also: |
actionPerformed,
addEventHandler,
adjustmentValueChanged,
caretUpdate,
componentHidden,
componentMoved,
componentResized,
componentShown,
dragDropEnd,
dragEnter,
dragExit,
dragGestureRecognized,
dragMouseMoved,
dragOver,
drop,
dropActionChanged,
Event,
focusGained,
focusLost,
hyperlinkActivated,
hyperlinkEntered,
hyperlinkExited,
invocationAction,
invocationBrowse,
invocationChange,
invocationEditKey,
InvocationEvent,
invocationRun,
invocationSelection,
itemStateChanged,
keyPressed,
keyReleased,
keyTyped,
mouseClicked,
mouseDragged,
mouseEntered,
mouseExited,
mouseMoved,
mousePressed,
mouseReleased,
mouseWheelMoved,
removeEventHandler,
stateChanged,
textValueChanged,
valueChanged,
windowActivated,
windowClosed,
windowClosing,
windowDeactivated,
windowDeiconified,
windowIconified,
windowOpened
|
|
