# com.bea.ide.ui.propertyeditor.editors
BuilderPropertyEditor Class

public class BuilderPropertyEditor
extends `DefaultPropertyEditor`

This property editor displays a button on the right side of the current property value that can be used to launch a custom property value editing interface. The Action passed in the constructor will be triggered on button press. The Action implementation, or the user interface it displays, is responsible for validating and setting the property value. as appropriate. However it is recommended that the writeValue method in this class is used to set the property value, particularly if the text field of this component is editable.

Hierarchy
  `Object`
  `Component`
  `Container`
  `JComponent`
  `JPanel`
  `DefaultPropertyEditor`
  `BuilderPropertyEditor`

All Implemented Interfaces
  `Accessible`, `EventListener`, `FocusListener`, `ImageObserver`, `IPropertyEditor`, `MenuContainer`, `MouseListener`, `Serializable`

Direct Known Subclasses
  `ColorChooserPropertyEditor`, `MultiLineTextPropertyEditor`

## Nested Class Summary

`public static class` | `BuilderPropertyEditor.BuilderButton`

Nested classes from javax.swing`.`JPanel``
``JPanel.AccessibleJPanel``

Nested classes from javax.swing`.`JComponent``
``JComponent.AccessibleJComponent``

Nested classes from java.awt`.`Container``
``Container.AccessibleAWTContainer``

Nested classes from java.awt`.`Component``
``Component.AccessibleAWTComponent`, `Component.BltBufferStrategy`, `Component.FlipBufferStrategy``

## Field Summary

Fields from javax.swing`.`JComponent``
`accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW`

Fields from java.awt`.`Component``
`BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT`

Fields from interface java.awt.image`.`ImageObserver``
`ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH`

## Constructor Summary

BuilderPropertyEditor(`IProperty` property, `IActionProxy` a, boolean isTextFieldEditable, `JFormattedTextField.AbstractFormatter` formatter) Generates a default builder button.
BuilderPropertyEditor(`IProperty` property, `IActionProxy` a, boolean isTextFieldEditable)
BuilderPropertyEditor(`IProperty` property, `JButton` button, boolean isTextFieldEditable, `JFormattedTextField.AbstractFormatter` formatter)

## Method Summary

`public void` | `focusGained`(`FocusEvent` e) Invoked when a component gains the keyboard focus.
`public void` | `focusLost`(`FocusEvent` e) Invoked when a component loses the keyboard focus.
`public void` | `mouseEntered`(`MouseEvent` e) This method is used for both text and button.
`public void` | `mouseExited`(`MouseEvent` e) This method is used for both text and button.
`public void` | `mousePressed`(`MouseEvent` e) This method is used for both text and button.

Methods from `com.bea.ide.ui.propertyeditor.editors.`DefaultPropertyEditor``
``activate`, `createDefaultFormatter`, `deactivate`, `getComponent`, `getProperty`, `getTextField`, `handleKeyPressedEvent`, `isFocusContainer`, `mouseClicked`, `mouseReleased`, `setFocused``

Methods from `javax.swing.`JPanel``
`getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI`

Methods from `javax.swing.`JComponent``
`addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI`

Methods from `java.awt.`Container``
`add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree`

Methods from `java.awt.`Component``
`action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate`

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

Methods from interface `javax.accessibility.`Accessible``
`getAccessibleContext`

Methods from interface `java.awt.event.`FocusListener``
`focusGained, focusLost`

Methods from interface `java.awt.image.`ImageObserver``
`imageUpdate`

Methods from interface `com.bea.ide.ui.propertyeditor.`IPropertyEditor``
``activate`, `deactivate`, `getComponent`, `getProperty`, `setFocused``

Methods from interface `java.awt.`MenuContainer``
`getFont, postEvent, remove`

Methods from interface `java.awt.event.`MouseListener``
`mouseClicked, mouseEntered, mouseExited, mousePressed, mouseReleased`

## Constructor Detail

### BuilderPropertyEditor

    public BuilderPropertyEditor(IProperty property,
                                 IActionProxy a,
                                 boolean isTextFieldEditable,
                                 JFormattedTextField.AbstractFormatter formatter)

  Generates a default builder button.

### BuilderPropertyEditor

    public BuilderPropertyEditor(IProperty property,
                                 IActionProxy a,
                                 boolean isTextFieldEditable)

### BuilderPropertyEditor

    public BuilderPropertyEditor(IProperty property,
                                 JButton button,
                                 boolean isTextFieldEditable,
                                 JFormattedTextField.AbstractFormatter formatter)

## Method Detail

### focusGained(FocusEvent) Method

    public void focusGained(FocusEvent e)

Invoked when a component gains the keyboard focus.

Overrides
  `DefaultPropertyEditor.focusGained(FocusEvent)`

Related Topics

``FocusListener.focusGained(FocusEvent)``

### focusLost(FocusEvent) Method

    public void focusLost(FocusEvent e)

Invoked when a component loses the keyboard focus.

Overrides
  `DefaultPropertyEditor.focusLost(FocusEvent)`

Related Topics

``FocusListener.focusLost(FocusEvent)``

### mouseEntered(MouseEvent) Method

    public void mouseEntered(MouseEvent e)

This method is used for both text and button.

Overrides
  `DefaultPropertyEditor.mouseEntered(MouseEvent)`

Related Topics

``MouseListener.mouseEntered(MouseEvent)``

### mouseExited(MouseEvent) Method

    public void mouseExited(MouseEvent e)

This method is used for both text and button.

Overrides
  `DefaultPropertyEditor.mouseExited(MouseEvent)`

Related Topics

``MouseListener.mouseExited(MouseEvent)``

### mousePressed(MouseEvent) Method

    public void mousePressed(MouseEvent e)

This method is used for both text and button.

Overrides
  `DefaultPropertyEditor.mousePressed(MouseEvent)`

Related Topics

``MouseListener.mousePressed(MouseEvent)``