Interface Highlighter

  • All Known Implementing Classes:
    AbstractHighlighter, BorderHighlighter, ColorHighlighter, CompoundHighlighter, HighlighterFactory.UIColorHighlighter, IconHighlighter, PainterHighlighter, ResetDTCRColorHighlighter, ShadingColorHighlighter

    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:
    ComponentAdapter, ComponentProvider
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void addChangeListener​(javax.swing.event.ChangeListener l)
      Adds a ChangeListener which are notified after changes of any attribute.
      javax.swing.event.ChangeListener[] getChangeListeners()
      Returns an array of all the change listeners registered on this LegacyHighlighter.
      java.awt.Component highlight​(java.awt.Component renderer, ComponentAdapter adapter)
      Decorates the specified component for the given component adapter.
      void removeChangeListener​(javax.swing.event.ChangeListener l)
      Removes a ChangeListener.
    • Method Detail

      • highlight

        java.awt.Component highlight​(java.awt.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