Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.0.0)

E17493-01

oracle.jdeveloper.webapp.metadata
Class ContextualComponentEditor

java.lang.Object
  extended by oracle.jdeveloper.webapp.metadata.ContextualComponentEditor

public abstract class ContextualComponentEditor
extends java.lang.Object

The ContextualComponentEditor interface that provides a custom editor that is able to edit a UI Component and its content. An instance of this interface can be reused in different editing contexts. Before the instance is reused the releaseEditor() will be called on it.

See Also:
ComponentEditorContext

Constructor Summary
ContextualComponentEditor()
           
 
Method Summary
 boolean componentDataChanged()
          Called when the component editor context has new component data available for the editor.
abstract  java.awt.Component getComponentEditor()
          Returns the Swing component that is UI representation of the component editor.
abstract  boolean handleModelChange(oracle.bali.xml.model.XmlModelEvent event)
          Gives a chance to the component editor to update its state when the underlyning model changes.
 void releaseEditor()
          Called by the component editor environment to tell the component editor to cleanup its state.
abstract  void setContext(ComponentEditorContext context)
          Called by the component editor environment to provide additional information.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ContextualComponentEditor

public ContextualComponentEditor()
Method Detail

setContext

public abstract void setContext(ComponentEditorContext context)
                         throws InvalidContextException
Called by the component editor environment to provide additional information. This method is always called once before all other to set up the component editor.

Parameters:
context - Contextual information.
Throws:
InvalidContextException - if the editor can not handle given ComponentEditorContext

releaseEditor

public void releaseEditor()
Called by the component editor environment to tell the component editor to cleanup its state. This method is always called once at the end of the editor usage. Only call that may be called immidiatly after this one is setContext(ComponentEditorContext) in case the editor is about to be reused.


componentDataChanged

public boolean componentDataChanged()
Called when the component editor context has new component data available for the editor. This usually happens as a response to the ComponentEditorContext.requestNewComponentData().

Returns:
True if the component editor can handle new component data. If false is returned editor will be automatically closed.

getComponentEditor

public abstract java.awt.Component getComponentEditor()
Returns the Swing component that is UI representation of the component editor.

Returns:

handleModelChange

public abstract boolean handleModelChange(oracle.bali.xml.model.XmlModelEvent event)
Gives a chance to the component editor to update its state when the underlyning model changes. Component editor should return true if it handled the model change completally, and the component editor environment does not need to process the event itself.

Parameters:
event -
Returns:
true if the component editor handled the model change completally

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.0.0)

E17493-01

Copyright © 1997, 2011, Oracle. All rights reserved.