IlvEditLabelInteractor (Perforce JViews 10.0 API)

java.lang.Object
- ilog.views.IlvManagerViewInteractor
- - ilog.views.interactor.IlvEditLabelInteractor

All Implemented Interfaces:

IlvPermanentInteractorInterface, Serializable

Direct Known Subclasses:

IltEditLabelInteractor, IlvEditSDMLabelInteractor
```
public class IlvEditLabelInteractor
extends IlvManagerViewInteractor
implements IlvPermanentInteractorInterface
```
IlvEditLabelInteractor lets the user create and edit a graphic object containing a label.
Overview

This class works in one of three available modes: creation only, edit only, or creation and edition. Any graphic object that displays a label and implements the IlvLabelInterface interface can be edited with an IlvEditLabelInteractor object. You can create any type of labeled graphic object by setting a factory of labeled objects.

Using the Edit Label Interactor

When this interactor is installed on a view, the following functionality is available to the user:
- When the user clicks an object that implements the IlvLabelInterface, an editor opens to edit the object.
- When the user clicks the background of the view, an editor is opened, and a graphic object of class IlvLabel is created when the edit is validated by the user.
An edit if validated in one of the following ways:
- When the text field is open, the user presses RETURN or clicks elsewhere on the view.
- When the edit field loses the keyboard focus.
When the text field is open in a Swing application, and the graphic object supports the base text direction (see IlvGraphic.setBaseTextDirection(int)), the user can change the base text direction while editing the label in the following way:
- Press Shift-Control-Left-Arrow to set the base text direction to right-to-left.
- Press Shift-Control-Right-Arrow to set the base text direction to left-to-right.
- Press Shift-Control-Down-Arrow to set the base text direction to contextual direction.
- Press Shift-Control-Up-Arrow to set the base text direction to component direction.
Example

The following code example shows how to use IlvEditLabelInteractor in a simple Java application:
```
 IlvManager mgr = new IlvManager();
 IlvManagerView view = new IlvManagerView(mgr);
 ...
 IlvEditLabelInteractor inter = new IlvEditLabelInteractor();
 view.setInteractor(inter);
 
```
About Interactors and Accelerators

IlvEditLabelInteractor is a custom global interactor, that is, a subclass of IlvManagerViewInteractor. A global interactor is a class that listens to a specific event in the manager view. All input events are handled by means of interactors or accelerators. For information about how to treat events in a manager, see Handling Events. The following code examples show how to handle user events:
See Also:

IlvLabelInterface, Serialized Form

Constructor Summary

Constructors
Constructor and Description

IlvEditLabelInteractor()
Creates the interactor.

Constructors
Constructor and Description
`IlvEditLabelInteractor()` Creates the interactor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected boolean`	`accept(IlvGraphic obj)` Verifies whether editing of the object is allowed.
`protected void`	`addObject(IlvGraphic obj)` Called by the interactor to add a newly created object in the manager.
`protected void`	`attach(IlvManagerView v)` Called when the interactor is attached to the manager view.
`protected Component`	`createEditComponent(boolean useSwing, boolean multi, ActionListener actionListener, FocusListener focusListener)` Allocates a component that allows you to edit the label.
`protected void`	`detach()` Called when the interactor is detached from the view.
`protected void`	`editObject(IlvGraphic obj, IlvPoint pt)` Called to do the actual editing of the graphic object, which may be `null` when creating a new one.
`protected boolean`	`ensureEditAreaInView()` Returns `true` if the label editing area used by this interactor always remains inside the bounds of the view.
`protected IlvRect`	`getEditingAreaBBox(IlvGraphic obj, IlvPoint pt, int nLines, int labelWidth, int lineHeight, int borderWidth, IlvTransformer t)` Used by the interactor to compute the bounding area of the text field used for editing the text in the graphic object.
`protected Font`	`getEditionFont(IlvGraphic obj)` Returns the font used to edit the object.
`Font`	`getFont()` Returns the font used to create the object.
`Color`	`getForeground()` Returns the foreground color used to create the object.
`protected IlvRect`	`getLabelBBox(IlvGraphic obj, IlvTransformer t)` Used by the interactor to compute the bounding area of the text in the graphic object.
`IlvLabeledObjectFactory`	`getObjectFactory()` Returns the factory installed, if any.
`protected String`	`getObjectLabel(IlvGraphic obj)` Retrieves the text from the edited object.
`boolean`	`isCreationAllowed()` Returns `true` if the interactor allows objects to be created.
`boolean`	`isCreationInSubManagersAllowed()` Returns `true` if the creation of objects in submanagers is allowed, and `false` otherwise.
`boolean`	`isEditionAllowed()` Returns `true` if the interactor allows objects to be edited.
`boolean`	`isGrapherMode()` Returns `true` if the interactor is in grapher mode.
`boolean`	`isPermanent()` Returns `false` if the interactor is removed from the view once the object has been edited.
`protected IlvGraphic`	`makeObject(IlvPoint p, String label)` Creates the object.
`protected void`	`processMouseEvent(MouseEvent event)` Processes the mouse events.
`void`	`setCreationAllowed(boolean set)` Allows objects to be created with this interactor (`true`).
`void`	`setCreationInSubManagersAllowed(boolean set)` Allows objects to be created in submanagers (see `IlvManager.getManagers()`).
`void`	`setEditionAllowed(boolean set)` Allows objects to be edited with this interactor (`true`).
`void`	`setFont(Font font)` Changes the font used to create the object.
`void`	`setForeground(Color color)` Changes the foreground color used to create the object.
`void`	`setGrapherMode(boolean value)` Sets the grapher mode value.
`void`	`setObjectFactory(IlvLabeledObjectFactory factory)` Sets a factory of labeled objects for the interactor.
`protected void`	`setObjectLabel(IlvGraphic obj, String str)` Changes the text of the edited object.
`void`	`setPermanent(boolean permanent)` Specifies whether the interactor is removed from the view once the object has been edited.
`protected boolean`	`supportMultiline(IlvGraphic obj)` Called to indicate whether the label of the object can have multiple lines.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - IlvEditLabelInteractor
```
public IlvEditLabelInteractor()
```
    Creates the interactor.
- Method Detail
  - attach
```
protected void attach(IlvManagerView v)
```
    Called when the interactor is attached to the manager view.
    
    Overrides:
    
    attach in class IlvManagerViewInteractor
    
    Parameters:
    
    v - The manager view.
    
    See Also:
    
    IlvManagerViewInteractor.detach()
  - detach
```
protected void detach()
```
    Called when the interactor is detached from the view.
    
    Overrides:
    
    detach in class IlvManagerViewInteractor
    
    See Also:
    
    IlvManagerViewInteractor.attach(ilog.views.IlvManagerView)
  - isEditionAllowed
```
public final boolean isEditionAllowed()
```
    Returns true if the interactor allows objects to be edited. The default value is true. Note that if editing is not allowed then you can only create objects with this interactor.
  - setEditionAllowed
```
public final void setEditionAllowed(boolean set)
```
    Allows objects to be edited with this interactor (true). Note that if editing is not allowed, you can only create objects with this interactor.
  - isCreationAllowed
```
public final boolean isCreationAllowed()
```
    Returns true if the interactor allows objects to be created. The default value is true. Note that if creation is not allowed then you can only edit objects with this interactor.
  - setCreationAllowed
```
public final void setCreationAllowed(boolean set)
```
    Allows objects to be created with this interactor (true). Note that if creation is not allowed, you can only edit objects with this interactor.
  - setCreationInSubManagersAllowed
```
public void setCreationInSubManagersAllowed(boolean set)
```
    Allows objects to be created in submanagers (see IlvManager.getManagers()). If creation in submanagers is not allowed, the object is always created in the IlvManager displayed by the IlvManagerView to which this interactor is attached.
    The default value is true.
    
    Since:
    
    JViews 5.0
  - isCreationInSubManagersAllowed
```
public boolean isCreationInSubManagersAllowed()
```
    Returns true if the creation of objects in submanagers is allowed, and false otherwise.
    
    Since:
    
    JViews 5.0
  - isPermanent
```
public final boolean isPermanent()
```
    Returns false if the interactor is removed from the view once the object has been edited. The default value is false.
    
    Specified by:
    
    isPermanent in interface IlvPermanentInteractorInterface
  - setPermanent
```
public final void setPermanent(boolean permanent)
```
    Specifies whether the interactor is removed from the view once the object has been edited. The default value is false.
    
    Specified by:
    
    setPermanent in interface IlvPermanentInteractorInterface
    
    Parameters:
    
    permanent - the new mode.
  - addObject
```
protected void addObject(IlvGraphic obj)
```
    Called by the interactor to add a newly created object in the manager. It simply calls addObject on the manager in default mode. It calls addNode on the grapher in grapher mode if the interactor is attached to a grapher view.
    
    Parameters:
    
    obj - The object to be added.
    
    See Also:
    
    setGrapherMode(boolean)
  - makeObject
```
protected IlvGraphic makeObject(IlvPoint p,
                                String label)
```
    Creates the object. This method is called to create the graphic object in case you have not selected an object for editing. The default implementation creates an instance of IlvLabel. If a factory is set for the interactor, it will be used to create the object.
    
    Parameters:
    
    p - The point indicating the object's position in the coordinate system of the manager to which the label will be added.
    
    label - The label.
    
    See Also:
    
    setObjectFactory(ilog.views.interactor.IlvLabeledObjectFactory)
  - setObjectFactory
```
public final void setObjectFactory(IlvLabeledObjectFactory factory)
```
    Sets a factory of labeled objects for the interactor. When a factory is set, it is responsible for creating the graphic object. If not, an object of class IlvLabel will be created.
    
    Parameters:
    
    factory - The new factory or null to remove the factory.
    
    Since:
    
    JViews 8.0
  - getObjectFactory
```
public IlvLabeledObjectFactory getObjectFactory()
```
    Returns the factory installed, if any.
    
    Since:
    
    JViews 8.0
  - getObjectLabel
```
protected String getObjectLabel(IlvGraphic obj)
```
    Retrieves the text from the edited object. This method is called to retrieve the text from the object that is being edited. The actual implementation uses the getLabel method of the interface IlvLabelInterface.
  - setObjectLabel
```
protected void setObjectLabel(IlvGraphic obj,
                              String str)
```
    Changes the text of the edited object. This method is called to change the text of the object that is being edited. The actual implementation uses the setLabel method of the interface IlvLabelInterface.
  - supportMultiline
```
protected boolean supportMultiline(IlvGraphic obj)
```
    Called to indicate whether the label of the object can have multiple lines. If true, a multiline editor is used for editing; otherwise, a single line editor is used. The actual implementation uses the supportMultiline method of the interface IlvLabelInterface.
    
    Parameters:
    
    obj - The object being edited or null. If this parameter is nullthen no object is edited, but a new object will be created. In this case, the method must return true if the created object supports a multiline label.
  - getLabelBBox
```
protected IlvRect getLabelBBox(IlvGraphic obj,
                               IlvTransformer t)
```
    Used by the interactor to compute the bounding area of the text in the graphic object. The result of this method is used to set the size and position of the edit field. The current implementation returns the result of the getLabelBBox method of the interface IlvLabelInterface if the graphic object implements this interface; otherwise it returns the bounding box of the object.
    
    See Also:
    
    editObject(IlvGraphic, IlvPoint), getEditingAreaBBox(IlvGraphic, IlvPoint, int, int, int, int, IlvTransformer)
  - getEditionFont
```
protected Font getEditionFont(IlvGraphic obj)
```
    Returns the font used to edit the object. This will be the font of the editing component. The current implementation returns the result of the method getFont of the interface IlvLabelInterface if the edited object implements this interface; otherwise a default font is returned.
    
    Parameters:
    
    obj - The edited object.
  - createEditComponent
```
protected Component createEditComponent(boolean useSwing,
                                        boolean multi,
                                        ActionListener actionListener,
                                        FocusListener focusListener)
```
    Allocates a component that allows you to edit the label. The default behavior is the following: in Swing, a JTextField is used for the single-line labels, and a JTextArea is used for labels that support multiple lines. In AWT, a TextField and a TextArea are used correspondingly.
    This message can be overridden if special components should be used for editing a label.
    
    Parameters:
    
    useSwing - Whether the manager view is embedded in a Swing component.
    
    multi - Whether the label support multiple lines.
    
    actionListener - The action listener to be performed on the component.
    
    focusListener - The focus listener to be performed on the component.
    
    Since:
    
    JViews 7.5
  - editObject
```
protected void editObject(IlvGraphic obj,
                          IlvPoint pt)
```
    Called to do the actual editing of the graphic object, which may be null when creating a new one. The default implementation is to pop up a text field to allow editing of the object.
    
    Parameters:
    
    obj - The graphic object to edit.
    
    pt - The mouse position in view coordinates.
    
    Since:
    
    JViews 5.0
    
    See Also:
    
    getEditingAreaBBox(IlvGraphic, IlvPoint, int, int, int, int, IlvTransformer), getLabelBBox(IlvGraphic, IlvTransformer)
  - getEditingAreaBBox
```
protected IlvRect getEditingAreaBBox(IlvGraphic obj,
                                     IlvPoint pt,
                                     int nLines,
                                     int labelWidth,
                                     int lineHeight,
                                     int borderWidth,
                                     IlvTransformer t)
```
    Used by the interactor to compute the bounding area of the text field used for editing the text in the graphic object. The method takes into account the rectangle returned by getLabelBBox(IlvGraphic, IlvTransformer).
    
    Parameters:
    
    obj - The graphic object to edit.
    
    pt - The mouse position in view coordinates.
    
    nLines - The number of lines of the label.
    
    labelWidth - The width of the label.
    
    lineHeight - The height of the text line.
    
    borderWidth - The width of the border to be preserved.
    
    t - The transformer used to draw the object.
    
    Returns:
    
    The bounding area of the text field used for editing the graphic object.
    
    Since:
    
    JViews 7.5
    
    See Also:
    
    editObject(IlvGraphic, IlvPoint), getLabelBBox(IlvGraphic, IlvTransformer)
  - accept
```
protected boolean accept(IlvGraphic obj)
```
    Verifies whether editing of the object is allowed. This method is called by the interactor to check whether the object obj can be edited. The current implementation only allows the editing of objects that implement the IlvLabelInterface.
  - processMouseEvent
```
protected void processMouseEvent(MouseEvent event)
```
    Processes the mouse events.
    
    Overrides:
    
    processMouseEvent in class IlvManagerViewInteractor
    
    Parameters:
    
    event - The event.
    
    See Also:
    
    IlvManagerViewInteractor.addMouseListener(java.awt.event.MouseListener)
  - getForeground
```
public Color getForeground()
```
    Returns the foreground color used to create the object.
  - setForeground
```
public void setForeground(Color color)
```
    Changes the foreground color used to create the object.
  - getFont
```
public Font getFont()
```
    Returns the font used to create the object.
  - setFont
```
public void setFont(Font font)
```
    Changes the font used to create the object.
  - isGrapherMode
```
public boolean isGrapherMode()
```
    Returns true if the interactor is in grapher mode. The default is false.
    
    See Also:
    
    setGrapherMode(boolean)
  - setGrapherMode
```
public void setGrapherMode(boolean value)
```
    Sets the grapher mode value. If true, created objects will be added to the grapher of the attached view with the addNode method. If false, they will be added with addObject.
    
    Parameters:
    
    value - The value to be set.
    
    See Also:
    
    isGrapherMode()
  - ensureEditAreaInView
```
protected boolean ensureEditAreaInView()
```
    Returns true if the label editing area used by this interactor always remains inside the bounds of the view. When the view is scrolled, the position of the label editing area may become different to the position of the label because the label can scroll outside the visible area of the view while the label editing area remains inside this visible area.
    Returns true by default. You can override this method to disable that the label editing area is limited to the view.
    
    Since:
    
    JViews 7.5

Class IlvEditLabelInteractor

Overview

Using the Edit Label Interactor

Example

About Interactors and Accelerators

Constructor Summary

Method Summary

Methods inherited from class ilog.views.IlvManagerViewInteractor

Methods inherited from class java.lang.Object

Constructor Detail

IlvEditLabelInteractor

Method Detail

attach

detach

isEditionAllowed

setEditionAllowed

isCreationAllowed

setCreationAllowed

setCreationInSubManagersAllowed

isCreationInSubManagersAllowed

isPermanent

setPermanent

addObject

makeObject

setObjectFactory

getObjectFactory

getObjectLabel

setObjectLabel

supportMultiline

getLabelBBox

getEditionFont

createEditComponent

editObject

getEditingAreaBBox

accept

processMouseEvent

getForeground

setForeground

getFont

setFont

isGrapherMode

setGrapherMode

ensureEditAreaInView