Interface Highlighter

All Known Implementing Classes:
AbstractHighlighter, AlignmentHighlighter, BorderHighlighter, ColorHighlighter, ComponentOrientationHighlighter, CompoundHighlighter, EnabledHighlighter, FontHighlighter, HighlighterFactory.UIColorHighlighter, IconHighlighter, PainterHighlighter, ResetDTCRColorHighlighter, ShadingColorHighlighter, ToolTipHighlighter

public interface Highlighter
Highlighter provide a mechanism to modify visual attributes of cell rendering components. The mechanism is uniform across both rendered and rendering component types: it is the same for SwingX collection views (JXTable, JXList, JXTree/Table) and independent of the concrete component type used for rendering the cell. The view cell state is factored into a ComponentAdapter.

For example, in data visualization components that support multiple columns with potentially different types of data, a ColorHighlighter imparts the same background color consistently across all columns of the rendered component regardless of the actual cell renderer registered for any specific column.

The highlightable properties are basically defined by the renderer in use: only attributes the renderer guarantees to reset on every call are safe to alter. For SwingX renderering support these are listed in ComponentProvider. Implementations supporting mutable internal state which effects the decoration must notify its listeners about the change. Typically, the rendered component installs a listener to its Highlighters and triggeres a repaint on notification.

See Also:
  • Method Details

    • highlight

      Component highlight(Component renderer, ComponentAdapter adapter)
      Decorates the specified component for the given component adapter.
      Parameters:
      renderer - the cell rendering component that is to be decorated
      adapter - the ComponentAdapter for this decorate operation
      Returns:
      the decorated cell rendering component
    • addChangeListener

      void addChangeListener(ChangeListener l)
      Adds a ChangeListener which are notified after changes of any attribute.
      Parameters:
      l - the ChangeListener to add
      See Also:
    • removeChangeListener

      void removeChangeListener(ChangeListener l)
      Removes a ChangeListener.
      Parameters:
      l - the ChangeListener to remove
      See Also:
    • getChangeListeners

      ChangeListener[] getChangeListeners()
      Returns an array of all the change listeners registered on this LegacyHighlighter.
      Returns:
      all of this model's ChangeListeners or an empty array if no change listeners are currently registered
      Since:
      1.4
      See Also: