Class Ip2Example.ExampleToolController

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

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


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


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