ix.test
Class Ip2Example.ExampleToolController

java.lang.Object
  extended by ix.iface.util.ToolController
      extended by ix.test.Ip2Example.ExampleToolController
Enclosing class:
Ip2Example

protected class Ip2Example.ExampleToolController
extends ToolController


Field Summary
 
Fields inherited from class ix.iface.util.ToolController
tool, toolName
 
Constructor Summary
Ip2Example.ExampleToolController(java.lang.String name)
           
 
Method Summary
 java.lang.Object createTool()
          Consturucts the tool when it does not already exist.
 
Methods inherited from class ix.iface.util.ToolController
ensureTool, ensureToolVisible, getTool, getToolName, setTool, setToolVisible
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Ip2Example.ExampleToolController

public Ip2Example.ExampleToolController(java.lang.String name)
Method Detail

createTool

public java.lang.Object createTool()
Description copied from class: ToolController
Consturucts the tool when it does not already exist.

This method should be called only if the ToolController.getTool() method returns null, and it should not normally be called directly. Call ToolController.setTool() instead, or use a method that calls ToolController.setTool(), such as ToolController.ensureTool().

That ensures that createTool is called only once per ToolController and that the controller remembers the tool so that ToolController.getTool() can return it. Note, however, that it is not strictly necessary for createTool to construct a new object. In some cases, it might return an existing object that has not yet been made known to this ToolController. For example, if two different frames share a tool, they would have separate ToolManagers and separate ToolControllers for the same tool object, but at most one of those controllers should construct a new tool object.

Specified by:
createTool in class ToolController