Class MatchingCharacterPainter

java.lang.Object
org.eclipse.jface.text.source.MatchingCharacterPainter
All Implemented Interfaces:
EventListener, IPainter, PaintListener, SWTEventListener

public final class MatchingCharacterPainter extends Object implements IPainter, PaintListener
Highlights the peer character matching the character near the caret position, or a pair of peer characters enclosing the caret position. This painter can be configured with an ICharacterPairMatcher or an ICharacterPairMatcherExtension.

Clients instantiate and configure an object of this class.

Since:
2.1
  • Constructor Details

    • MatchingCharacterPainter

      public MatchingCharacterPainter(ISourceViewer sourceViewer, ICharacterPairMatcher matcher)
      Creates a new MatchingCharacterPainter for the given source viewer using the given character pair matcher. The character matcher is not adopted by this painter. Thus, it is not disposed. However, this painter requires exclusive access to the given pair matcher.
      Parameters:
      sourceViewer - the source viewer
      matcher - the character pair matcher
  • Method Details

    • setHighlightCharacterAtCaretLocation

      public void setHighlightCharacterAtCaretLocation(boolean highlightCharacterAtCaretLocation)
      Sets whether to highlight the character at caret location or not.
      Parameters:
      highlightCharacterAtCaretLocation - whether to highlight the character at caret location or not
      Since:
      3.8
    • setHighlightEnclosingPeerCharacters

      public void setHighlightEnclosingPeerCharacters(boolean highlightEnclosingPeerCharcters)
      Sets whether to highlight enclosing peer characters or not.
      Parameters:
      highlightEnclosingPeerCharcters - whether to highlight enclosing peer characters or not
      Since:
      3.8
    • setColor

      public void setColor(Color color)
      Sets the color in which to highlight the match character.
      Parameters:
      color - the color
    • dispose

      public void dispose()
      Description copied from interface: IPainter
      Disposes this painter. Prior to disposing, a painter should be deactivated. A disposed painter can not be reactivated.
      Specified by:
      dispose in interface IPainter
      See Also:
    • deactivate

      public void deactivate(boolean redraw)
      Description copied from interface: IPainter
      Deactivates this painter. If the painter is inactive, this call does not have any effect. redraw indicates whether the painter should remove any decoration it previously applied. A deactivated painter can be reactivated by calling paint.
      Specified by:
      deactivate in interface IPainter
      Parameters:
      redraw - true if any previously applied decoration should be removed
      See Also:
    • paintControl

      public void paintControl(PaintEvent event)
      Description copied from interface: PaintListener
      Sent when a paint event occurs for the control.
      Specified by:
      paintControl in interface PaintListener
      Parameters:
      event - an event containing information about the paint
    • paint

      public void paint(int reason)
      Description copied from interface: IPainter
      Requests this painter to repaint because of the given reason. Based on the given reason the painter can decide whether it will repaint or not. If it repaints and is inactive, it will activate itself.
      Specified by:
      paint in interface IPainter
      Parameters:
      reason - the repaint reason, value is one of the constants defined in this interface
    • setPositionManager

      public void setPositionManager(IPaintPositionManager manager)
      Description copied from interface: IPainter
      Sets the paint position manager that can be used by this painter or removes any previously set paint position manager.
      Specified by:
      setPositionManager in interface IPainter
      Parameters:
      manager - the paint position manager or null