WebObjects 5.2.3

com.webobjects.eointerface
Class EOTableColumnAssociation.TableColumnPlugin

java.lang.Object
  extended bycom.webobjects.eointerface.EOWidgetAssociation.WidgetPlugin
      extended bycom.webobjects.eointerface.EOTableColumnAssociation.TableColumnPlugin
All Implemented Interfaces:
NSDisposable
Direct Known Subclasses:
EOCocoaTableColumnPlugin, EOSwingTableColumnPlugin
Enclosing class:
EOTableColumnAssociation

public abstract static class EOTableColumnAssociation.TableColumnPlugin
extends EOWidgetAssociation.WidgetPlugin

TableColumnPlugin communicates with a UI widget (Cocoa's NSTableColumn or JFC's TableColumn, for example) on behalf of an EOTableAssociation. The TableColumnPlugin class defines some basic functionality concrete subclasses must implement for this communication to work.


Nested Class Summary
 
Nested classes inherited from class com.webobjects.eointerface.EOWidgetAssociation.WidgetPlugin
EOWidgetAssociation.WidgetPlugin.Formatting
 
Constructor Summary
EOTableColumnAssociation.TableColumnPlugin(EOWidgetAssociation association, Object widget)
          Creates a new TableColumnPlugin for use with association and widget.
 
Method Summary
abstract  int columnIndexInTable()
          Gets the positional index of the plugin's column.
abstract  Object displayValueForValue(Object value)
          Formats a data value for display (potentially using a Formatter object as defined in subclasses).
 boolean endEditing()
          Asks the plugin to halt editing of its widget in the UI.
abstract  boolean isEditable()
          This method returns a flag indicating whether the TableColumn is editable.
abstract  Object table()
          This method is usually called internally and used to obtain the table widget from the column widget.
abstract  EOTableAssociation tableAssociation()
          Returns an association for the table of this plugin's column.
abstract  Object valueForDisplayValue(Object displayValue)
          This method performs the reverse operation of formatting, that is, it returns the data value for a displayed value, potentially using a Formatter object's "parse" method as defined in subclasses.
 
Methods inherited from class com.webobjects.eointerface.EOWidgetAssociation.WidgetPlugin
association, breakConnection, dispose, establishConnection, unacceptableAspects, widget, widgetKeysTaken
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

EOTableColumnAssociation.TableColumnPlugin

public EOTableColumnAssociation.TableColumnPlugin(EOWidgetAssociation association,
                                                  Object widget)
Creates a new TableColumnPlugin for use with association and widget.

Parameters:
association - EOTableColumnAssociation for this plugin to communicate with
widget - the table column object for this plugin to manage
Method Detail

columnIndexInTable

public abstract int columnIndexInTable()
Gets the positional index of the plugin's column.

Returns:
positional index of the plugin's table column widget in its table widget 0 is the first column on the left, -1 if this column isn't in a table

displayValueForValue

public abstract Object displayValueForValue(Object value)
Formats a data value for display (potentially using a Formatter object as defined in subclasses).

Parameters:
value - the data value to be displayed, usually coming from the display group set in the association
Returns:
the value formatted for display (a String)

endEditing

public boolean endEditing()
Asks the plugin to halt editing of its widget in the UI.

Returns:
true if editing ended successfully, false if the widget would not allow editing to end, typically because of a formatting error

isEditable

public abstract boolean isEditable()
This method returns a flag indicating whether the TableColumn is editable.

Returns:
true if the column is editable, false otherwsie

table

public abstract Object table()
This method is usually called internally and used to obtain the table widget from the column widget.

Returns:
the table view object that contains this plugin's table column

tableAssociation

public abstract EOTableAssociation tableAssociation()
Returns an association for the table of this plugin's column.

Returns:
an association for the table, if available, otherwise null

valueForDisplayValue

public abstract Object valueForDisplayValue(Object displayValue)
This method performs the reverse operation of formatting, that is, it returns the data value for a displayed value, potentially using a Formatter object's "parse" method as defined in subclasses. Note that there may be a loss of precision or detail depending on the display value.

Parameters:
displayValue - the (String) value as it was displayed and/or entered by the user
Returns:
the data value parsed from the display value

Last updated Thu Oct 21 15:04:16 PDT 2004.

Copyright © 2004 Apple Computer, Inc.