weka.gui
Class GenericObjectEditor

java.lang.Object
  |
  +--weka.gui.GenericObjectEditor
All Implemented Interfaces:
java.beans.PropertyEditor

public class GenericObjectEditor
extends java.lang.Object
implements java.beans.PropertyEditor

A PropertyEditor for objects that themselves have been defined as editable in the GenericObjectEditor configuration file, which lists possible values that can be selected from, and themselves configured. The configuration file is called "GenericObjectEditor.props" and may live in either the location given by "user.home" or the current directory (this last will take precedence), and a default properties file is read from the weka distribution. For speed, the properties file is read only once when the class is first loaded -- this may need to be changed if we ever end up running in a Java OS ;-).

Author:
Len Trigg (trigg@cs.waikato.ac.nz)

Inner Class Summary
 class GenericObjectEditor.GOEPanel
          Handles the GUI side of editing values.
 
Field Summary
protected static java.lang.String PROPERTY_FILE
          The name of the properties file
 
Constructor Summary
GenericObjectEditor()
           
 
Method Summary
 void addPropertyChangeListener(java.beans.PropertyChangeListener l)
          Adds a PropertyChangeListener who will be notified of value changes.
 java.lang.String getAsText()
          Returns null as we don't support getting/setting values as text.
protected  java.util.Vector getClassesFromProperties()
          Called when the class of object being edited changes.
 java.awt.Component getCustomEditor()
          Returns the array editing component.
 java.lang.String getJavaInitializationString()
          Supposedly returns an initialization string to create a Object identical to the current one, including it's state, but this doesn't appear possible given that the initialization string isn't supposed to contain multiple statements.
 java.lang.String[] getTags()
          Returns null as we don't support getting values as tags.
 java.lang.Object getValue()
          Gets the current Object.
 boolean isPaintable()
          Returns true to indicate that we can paint a representation of the Object.
static void main(java.lang.String[] args)
          Tests out the Object editor from the command line.
 void paintValue(java.awt.Graphics gfx, java.awt.Rectangle box)
          Paints a representation of the current Object.
 void removePropertyChangeListener(java.beans.PropertyChangeListener l)
          Removes a PropertyChangeListener.
 void setAsText(java.lang.String text)
          Returns null as we don't support getting/setting values as text.
 void setClassType(java.lang.Class type)
          Sets the class of values that can be edited.
 void setDefaultValue()
          Sets the current object to be the default, taken as the first item in the chooser
 void setEnabled(boolean newVal)
          Sets whether the editor is "enabled", meaning that the current values will be painted.
 void setValue(java.lang.Object o)
          Sets the current Object.
 boolean supportsCustomEditor()
          Returns true because we do support a custom editor.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

PROPERTY_FILE

protected static java.lang.String PROPERTY_FILE
The name of the properties file
Constructor Detail

GenericObjectEditor

public GenericObjectEditor()
Method Detail

getClassesFromProperties

protected java.util.Vector getClassesFromProperties()
Called when the class of object being edited changes.

setEnabled

public void setEnabled(boolean newVal)
Sets whether the editor is "enabled", meaning that the current values will be painted.
Parameters:
newVal - a value of type 'boolean'

setClassType

public void setClassType(java.lang.Class type)
Sets the class of values that can be edited.
Parameters:
type - a value of type 'Class'

setDefaultValue

public void setDefaultValue()
Sets the current object to be the default, taken as the first item in the chooser

setValue

public void setValue(java.lang.Object o)
Sets the current Object. If the Object is in the Object chooser, this becomes the selected item (and added to the chooser if necessary).
Specified by:
setValue in interface java.beans.PropertyEditor
Parameters:
o - an object that must be a Object.

getValue

public java.lang.Object getValue()
Gets the current Object.
Specified by:
getValue in interface java.beans.PropertyEditor
Returns:
the current Object

getJavaInitializationString

public java.lang.String getJavaInitializationString()
Supposedly returns an initialization string to create a Object identical to the current one, including it's state, but this doesn't appear possible given that the initialization string isn't supposed to contain multiple statements.
Specified by:
getJavaInitializationString in interface java.beans.PropertyEditor
Returns:
the java source code initialisation string

isPaintable

public boolean isPaintable()
Returns true to indicate that we can paint a representation of the Object.
Specified by:
isPaintable in interface java.beans.PropertyEditor
Returns:
true

paintValue

public void paintValue(java.awt.Graphics gfx,
                       java.awt.Rectangle box)
Paints a representation of the current Object.
Specified by:
paintValue in interface java.beans.PropertyEditor
Parameters:
gfx - the graphics context to use
box - the area we are allowed to paint into

getAsText

public java.lang.String getAsText()
Returns null as we don't support getting/setting values as text.
Specified by:
getAsText in interface java.beans.PropertyEditor
Returns:
null

setAsText

public void setAsText(java.lang.String text)
               throws java.lang.IllegalArgumentException
Returns null as we don't support getting/setting values as text.
Specified by:
setAsText in interface java.beans.PropertyEditor
Parameters:
text - the text value
Throws:
java.lang.IllegalArgumentException - as we don't support getting/setting values as text.

getTags

public java.lang.String[] getTags()
Returns null as we don't support getting values as tags.
Specified by:
getTags in interface java.beans.PropertyEditor
Returns:
null

supportsCustomEditor

public boolean supportsCustomEditor()
Returns true because we do support a custom editor.
Specified by:
supportsCustomEditor in interface java.beans.PropertyEditor
Returns:
true

getCustomEditor

public java.awt.Component getCustomEditor()
Returns the array editing component.
Specified by:
getCustomEditor in interface java.beans.PropertyEditor
Returns:
a value of type 'java.awt.Component'

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener l)
Adds a PropertyChangeListener who will be notified of value changes.
Specified by:
addPropertyChangeListener in interface java.beans.PropertyEditor
Parameters:
l - a value of type 'PropertyChangeListener'

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener l)
Removes a PropertyChangeListener.
Specified by:
removePropertyChangeListener in interface java.beans.PropertyEditor
Parameters:
l - a value of type 'PropertyChangeListener'

main

public static void main(java.lang.String[] args)
Tests out the Object editor from the command line.
Parameters:
args - may contain the class name of a Object to edit