Class Gutter
- All Implemented Interfaces:
ImageObserver
,MenuContainer
,Serializable
,Accessible
Icons can be added on a per-line basis to visually mark syntax errors, lines
with breakpoints set on them, etc. To add icons to the gutter, you must
first call RTextScrollPane.setIconRowHeaderEnabled(boolean)
on the
parent scroll pane, to make the icon area visible. Then, you can add icons
that track either lines in the document, or offsets, via
addLineTrackingIcon(int, Icon)
and
addOffsetTrackingIcon(int, Icon)
, respectively. To remove an
icon you've added, use removeTrackingIcon(GutterIconInfo)
.
In addition to support for arbitrary per-line icons, this component also has built-in support for displaying icons representing "bookmarks;" that is, lines a user can cycle through via F2 and Shift+F2. Bookmarked lines are toggled via Ctrl+F2. In order to enable bookmarking, you must first assign an icon to represent a bookmarked line, then actually enable the feature:
Gutter gutter = scrollPane.getGutter(); gutter.setBookmarkIcon(new ImageIcon("bookmark.png")); gutter.setBookmarkingEnabled(true);
- Version:
- 1.0
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic class
The border used by the gutter.private class
Listens for the text area resizing.Nested classes/interfaces inherited from class javax.swing.JPanel
JPanel.AccessibleJPanel
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate boolean
Whether this gutter, or any child components, are armed.private Color
The color used to render the currently active line's line number.static final Color
The color used to highlight active line ranges if none is specified.private FoldIndicator
Shows lines that are code-foldable.private IconRowHeader
Renders bookmark icons, breakpoints, error icons, etc.private boolean
Whether the icon area inherits the gutter background (as opposed to painting with its own, default "panel" color).private Color
The color used to render line numbers.private Font
The font used to render line numbers.private LineNumberFormatter
Formats line numbers into a string to be displayed.private int
The starting index for line numbers in the gutter.private LineNumberList
Renders line numbers.private Gutter.TextAreaListener
Listens for events in our text area.private int
Optional additional spacing between the line number component and the fold indicator component.private RTextArea
The text area.Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddLineTrackingIcon
(int line, Icon icon) Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers.addLineTrackingIcon
(int line, Icon icon, String tip) Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers.addOffsetTrackingIcon
(int offs, Icon icon) Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers.addOffsetTrackingIcon
(int offs, Icon icon, String tip) Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers.private void
Clears the active line range.Returns the color used to paint the active line range, if any.Returns the background color used by the (default) fold icons when they are armed.Returns the icon to use for bookmarks.Returns the bookmarks known to this gutter.Returns the color of the "border" line.The color used to render the currently active line's line number.Returns the strategy to use for rendering expanded folds.Returns the background color used by the (default) fold icons.Returns the foreground color of the fold indicator for armed folds.Returns the foreground color of the fold indicator.boolean
Returns whether the icon area inherits the gutter background (as opposed to painting with its own, default "panel" color, which is the default).Returns the color to use to paint line numbers.Returns the font used for line numbers.Returns the line number formatter.int
Returns the starting line's line number.boolean
Returnstrue
if the line numbers are enabled and visible.boolean
Returns whether tool tips are displayed showing the contents of collapsed fold regions when the mouse hovers over a +/- icon.int
Returns the additional spacing between the line number list and fold indicator.Returns the tracking icons at the specified view position.boolean
isArmed()
Returns whether this gutter is "armed", that is, any child components are armed.boolean
Returns whether bookmarking is enabled.boolean
Returns whether the fold indicator is enabled.boolean
Returns whether the icon row header is enabled.void
Removes all tracking icons.void
Removes the specified tracking icon.private void
setActiveLineRange
(int startLine, int endLine) Highlights a range of lines in the icon area.void
setActiveLineRangeColor
(Color color) Sets the color to use to render active line ranges.(package private) void
setArmed
(boolean armed) Toggles whether this gutter is "armed", that is, any child components are armed.void
Sets the background color used by the (default) fold icons when they are armed.void
setBookmarkIcon
(Icon icon) Sets the icon to use for bookmarks.void
setBookmarkingEnabled
(boolean enabled) Sets whether bookmarking is enabled.void
void
setBorderColor
(Color color) Sets the color for the "border" line.void
void
setCurrentLineNumberColor
(Color color) Sets the color used to render the currently active line's line number.void
Sets the strategy to use for rendering expanded folds.void
Sets the background color used by the (default) fold icons.void
setFoldIcons
(FoldIndicatorIcon collapsedIcon, FoldIndicatorIcon expandedIcon) Sets the icons to use to represent collapsed and expanded folds.void
Sets the foreground color used by the fold indicator for armed folds.void
setFoldIndicatorEnabled
(boolean enabled) Toggles whether the fold indicator is enabled.void
Sets the foreground color used by the fold indicator.void
Toggles the presentation of the fold region of this component.void
setIconRowHeaderEnabled
(boolean enabled) Toggles whether the icon row header (used for breakpoints, bookmarks, etc.) is enabled.void
setIconRowHeaderInheritsGutterBackground
(boolean inherits) Sets whether the icon area inherits the gutter background (as opposed to painting with its own, default "panel" color, which is the default).void
setLineNumberColor
(Color color) Sets the color to use to paint line numbers.void
setLineNumberFont
(Font font) Sets the font used for line numbers.void
setLineNumberFormatter
(LineNumberFormatter formatter) Sets a custom line number formatter.void
setLineNumberingStartIndex
(int index) Sets the starting line's line number.void
setLineNumbersEnabled
(boolean enabled) Toggles whether line numbers are visible.void
setShowCollapsedRegionToolTips
(boolean show) Toggles whether tool tips should be displayed showing the contents of collapsed fold regions when the mouse hovers over a +/- icon.void
setSpacingBetweenLineNumbersAndFoldIndicator
(int spacing) Sets additional spacing between the line number list and fold indicator.void
setTextArea
(RTextArea textArea) Sets the text area being displayed.boolean
toggleBookmark
(int line) Programmatically toggles whether there is a bookmark for the specified line.Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Field Details
-
DEFAULT_ACTIVE_LINE_RANGE_COLOR
The color used to highlight active line ranges if none is specified. -
textArea
The text area. -
lineNumberList
Renders line numbers. -
lineNumberColor
The color used to render line numbers. -
currentLineNumberColor
The color used to render the currently active line's line number. If this isnull
,lineNumberColor
is used. -
lineNumberingStartIndex
private int lineNumberingStartIndexThe starting index for line numbers in the gutter. -
lineNumberFormatter
Formats line numbers into a string to be displayed. -
lineNumberFont
The font used to render line numbers. -
iconArea
Renders bookmark icons, breakpoints, error icons, etc. -
iconRowHeaderInheritsGutterBackground
private boolean iconRowHeaderInheritsGutterBackgroundWhether the icon area inherits the gutter background (as opposed to painting with its own, default "panel" color). -
spacingBetweenLineNumbersAndFoldIndicator
private int spacingBetweenLineNumbersAndFoldIndicatorOptional additional spacing between the line number component and the fold indicator component. -
foldIndicator
Shows lines that are code-foldable. -
armed
private boolean armedWhether this gutter, or any child components, are armed. Used internally for e.g. the fold indicator's appearance. -
listener
Listens for events in our text area.
-
-
Constructor Details
-
Gutter
Constructor.- Parameters:
textArea
- The parent text area.
-
-
Method Details
-
addLineTrackingIcon
Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers. This is useful for marking things such as source code errors.- Parameters:
line
- The line to track (zero-based).icon
- The icon to display. This should be small (say 16x16).- Returns:
- A tag for this icon. This can later be used in a call to
removeTrackingIcon(GutterIconInfo)
to remove this icon. - Throws:
BadLocationException
- Ifoffs
is an invalid offset into the text area.- See Also:
-
addLineTrackingIcon
public GutterIconInfo addLineTrackingIcon(int line, Icon icon, String tip) throws BadLocationException Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers. This is useful for marking things such as source code errors.- Parameters:
line
- The line to track (zero-based).icon
- The icon to display. This should be small (say 16x16).tip
- An optional tool tip for the icon.- Returns:
- A tag for this icon. This can later be used in a call to
removeTrackingIcon(GutterIconInfo)
to remove this icon. - Throws:
BadLocationException
- Ifoffs
is an invalid offset into the text area.- See Also:
-
addOffsetTrackingIcon
Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers. This is useful for marking things such as source code errors.- Parameters:
offs
- The offset to track.icon
- The icon to display. This should be small (say 16x16).- Returns:
- A tag for this icon.
- Throws:
BadLocationException
- Ifoffs
is an invalid offset into the text area.- See Also:
-
addOffsetTrackingIcon
public GutterIconInfo addOffsetTrackingIcon(int offs, Icon icon, String tip) throws BadLocationException Adds an icon that tracks an offset in the document, and is displayed adjacent to the line numbers. This is useful for marking things such as source code errors.- Parameters:
offs
- The offset to track.icon
- The icon to display. This should be small (say 16x16).tip
- An optional tool tip for the icon.- Returns:
- A tag for this icon.
- Throws:
BadLocationException
- Ifoffs
is an invalid offset into the text area.- See Also:
-
clearActiveLineRange
private void clearActiveLineRange()Clears the active line range.- See Also:
-
getActiveLineRangeColor
Returns the color used to paint the active line range, if any.- Returns:
- The color.
- See Also:
-
getArmedFoldBackground
Returns the background color used by the (default) fold icons when they are armed.- Returns:
- The background color.
- See Also:
-
getBookmarkIcon
Returns the icon to use for bookmarks.- Returns:
- The icon to use for bookmarks. If this is
null
, bookmarking is effectively disabled. - See Also:
-
getBookmarks
Returns the bookmarks known to this gutter.- Returns:
- The bookmarks. If there are no bookmarks, an empty array is returned.
- See Also:
-
getBorderColor
Returns the color of the "border" line.- Returns:
- The color.
- See Also:
-
getCurrentLineNumberColor
The color used to render the currently active line's line number. If this isnull
,getLineNumberColor()
is used.- Returns:
- The color.
- See Also:
-
getExpandedFoldRenderStrategy
Returns the strategy to use for rendering expanded folds.- Returns:
- The strategy to use for rendering expanded folds.
- See Also:
-
getFoldBackground
Returns the background color used by the (default) fold icons.- Returns:
- The background color.
- See Also:
-
getFoldIndicatorArmedForeground
Returns the foreground color of the fold indicator for armed folds.- Returns:
- The foreground color of the fold indicator for armed folds.
- See Also:
-
getFoldIndicatorForeground
Returns the foreground color of the fold indicator.- Returns:
- The foreground color of the fold indicator.
- See Also:
-
getIconRowHeaderInheritsGutterBackground
public boolean getIconRowHeaderInheritsGutterBackground()Returns whether the icon area inherits the gutter background (as opposed to painting with its own, default "panel" color, which is the default).- Returns:
- Whether the gutter background is used in the icon row header.
- See Also:
-
getLineNumberColor
Returns the color to use to paint line numbers.- Returns:
- The color used when painting line numbers.
- See Also:
-
getLineNumberFont
Returns the font used for line numbers.- Returns:
- The font used for line numbers.
- See Also:
-
getLineNumberingStartIndex
public int getLineNumberingStartIndex()Returns the starting line's line number. The default value is1
.- Returns:
- The index
- See Also:
-
getLineNumberFormatter
Returns the line number formatter. The default value isLineNumberList.DEFAULT_LINE_NUMBER_FORMATTER
- Returns:
- The formatter.
- See Also:
-
getLineNumbersEnabled
public boolean getLineNumbersEnabled()Returnstrue
if the line numbers are enabled and visible.- Returns:
- Whether line numbers are visible.
-
getShowCollapsedRegionToolTips
public boolean getShowCollapsedRegionToolTips()Returns whether tool tips are displayed showing the contents of collapsed fold regions when the mouse hovers over a +/- icon.- Returns:
- Whether these tool tips are displayed.
- See Also:
-
getSpacingBetweenLineNumbersAndFoldIndicator
public int getSpacingBetweenLineNumbersAndFoldIndicator()Returns the additional spacing between the line number list and fold indicator. By default this is a small amount; if you want something larger, you can increase it. Note this value takes effect whether both line numbers and the fold indicator are enabled, so use it only when both are enabled.- Returns:
- The additional spacing.
- See Also:
-
getTrackingIcons
Returns the tracking icons at the specified view position.- Parameters:
p
- The view position.- Returns:
- The tracking icons at that position. If there are no tracking icons there, this will be an empty array.
- Throws:
BadLocationException
- Ifp
is invalid.
-
isArmed
public boolean isArmed()Returns whether this gutter is "armed", that is, any child components are armed. This is used by the internal API and should not be called.- Returns:
- Whether the gutter is armed.
- See Also:
-
isFoldIndicatorEnabled
public boolean isFoldIndicatorEnabled()Returns whether the fold indicator is enabled.- Returns:
- Whether the fold indicator is enabled.
- See Also:
-
isBookmarkingEnabled
public boolean isBookmarkingEnabled()Returns whether bookmarking is enabled.- Returns:
- Whether bookmarking is enabled.
- See Also:
-
isIconRowHeaderEnabled
public boolean isIconRowHeaderEnabled()Returns whether the icon row header is enabled.- Returns:
- Whether the icon row header is enabled.
-
removeAllTrackingIcons
public void removeAllTrackingIcons()Removes all tracking icons.- See Also:
-
removeTrackingIcon
Removes the specified tracking icon.- Parameters:
tag
- A tag for an icon in the gutter, as returned from eitheraddLineTrackingIcon(int, Icon)
oraddOffsetTrackingIcon(int, Icon)
.- See Also:
-
setActiveLineRangeColor
Sets the color to use to render active line ranges.- Parameters:
color
- The color to use. If this is null, then the default color is used.- See Also:
-
setActiveLineRange
private void setActiveLineRange(int startLine, int endLine) Highlights a range of lines in the icon area. This, of course, will only be visible if the icon area is visible.- Parameters:
startLine
- The start of the line range.endLine
- The end of the line range.- See Also:
-
setArmed
void setArmed(boolean armed) Toggles whether this gutter is "armed", that is, any child components are armed. This is used by the internal API and should not be called.- Parameters:
armed
- Whether the gutter is armed.- See Also:
-
setArmedFoldBackground
Sets the background color used by the (default) fold icons when they are armed.- Parameters:
bg
- The new background color. If this isnull
, then armed fold icons will not render with a special color.- See Also:
-
setBookmarkIcon
Sets the icon to use for bookmarks.- Parameters:
icon
- The new bookmark icon. If this isnull
, bookmarking is effectively disabled.- See Also:
-
setBookmarkingEnabled
public void setBookmarkingEnabled(boolean enabled) Sets whether bookmarking is enabled. Note that a bookmarking icon must be set viasetBookmarkIcon(Icon)
before bookmarks are truly enabled.- Parameters:
enabled
- Whether bookmarking is enabled.- See Also:
-
setBorderColor
Sets the color for the "border" line.- Parameters:
color
- The new color.- See Also:
-
setComponentOrientation
- Overrides:
setComponentOrientation
in classComponent
-
setCurrentLineNumberColor
Sets the color used to render the currently active line's line number. If this isnull
,getLineNumberColor()
is used.- Parameters:
color
- The color to use.- See Also:
-
setExpandedFoldRenderStrategy
Sets the strategy to use for rendering expanded folds.- Parameters:
strategy
- The strategy to use. This cannot benull
.- See Also:
-
setFoldIcons
Sets the icons to use to represent collapsed and expanded folds. This method can be used for further customization after setting this component's general appearance viasetFoldIndicatorStyle(FoldIndicatorStyle)
.- Parameters:
collapsedIcon
- The collapsed fold icon. This cannot benull
.expandedIcon
- The expanded fold icon. This cannot benull
.- See Also:
-
setFoldIndicatorEnabled
public void setFoldIndicatorEnabled(boolean enabled) Toggles whether the fold indicator is enabled.- Parameters:
enabled
- Whether the fold indicator should be enabled.- See Also:
-
setFoldIndicatorStyle
Toggles the presentation of the fold region of this component. This method sets the icons used for fold regions to default values, amongst other configuration. To further customize those icons, seesetFoldIcons(FoldIndicatorIcon, FoldIndicatorIcon)
.- Parameters:
style
- The new presentation style.- See Also:
-
setFoldBackground
Sets the background color used by the (default) fold icons.- Parameters:
bg
- The new background color.- See Also:
-
setFoldIndicatorArmedForeground
Sets the foreground color used by the fold indicator for armed folds.- Parameters:
fg
- The new armed fold indicator foreground.- See Also:
-
setFoldIndicatorForeground
Sets the foreground color used by the fold indicator.- Parameters:
fg
- The new fold indicator foreground.- See Also:
-
setIconRowHeaderEnabled
public void setIconRowHeaderEnabled(boolean enabled) Toggles whether the icon row header (used for breakpoints, bookmarks, etc.) is enabled.Most clients do not need to call this method directly. This is usually handled by `RTextScrollPane` directly. Calling this directly may require the caller to ensure this `gutter` is visible and sized properly in its parent container.
- Parameters:
enabled
- Whether the icon row header is enabled.- See Also:
-
setIconRowHeaderInheritsGutterBackground
public void setIconRowHeaderInheritsGutterBackground(boolean inherits) Sets whether the icon area inherits the gutter background (as opposed to painting with its own, default "panel" color, which is the default).- Parameters:
inherits
- Whether the gutter background should be used in the icon row header. If this isfalse
, a default, Look-and-feel-dependent color is used.- See Also:
-
setLineNumberColor
Sets the color to use to paint line numbers.- Parameters:
color
- The color to use when painting line numbers.- See Also:
-
setLineNumberFont
Sets the font used for line numbers.- Parameters:
font
- The font to use. This cannot benull
.- See Also:
-
setLineNumberingStartIndex
public void setLineNumberingStartIndex(int index) Sets the starting line's line number. The default value is1
. Applications can call this method to change this value if they are displaying a subset of lines in a file, for example.- Parameters:
index
- The new index.- See Also:
-
setLineNumberFormatter
Sets a custom line number formatter. Can be called when other number formats are needed like hindu-arabic numerals.- Parameters:
formatter
- The new line number formatter.- See Also:
-
setLineNumbersEnabled
public void setLineNumbersEnabled(boolean enabled) Toggles whether line numbers are visible.Most clients do not need to call this method directly. This is usually handled by `RTextScrollPane` directly. Calling this directly may require the caller to ensure this `gutter` is visible and sized properly in its parent container.
- Parameters:
enabled
- Whether line numbers should be visible.- See Also:
-
setShowCollapsedRegionToolTips
public void setShowCollapsedRegionToolTips(boolean show) Toggles whether tool tips should be displayed showing the contents of collapsed fold regions when the mouse hovers over a +/- icon.- Parameters:
show
- Whether to show these tool tips.- See Also:
-
setSpacingBetweenLineNumbersAndFoldIndicator
public void setSpacingBetweenLineNumbersAndFoldIndicator(int spacing) Sets additional spacing between the line number list and fold indicator. By default this is a small amount; if you want something larger, you can increase it. Note this value takes effect whether both line numbers and the fold indicator are enabled, so use it only when both are enabled.- Parameters:
spacing
- The additional spacing. This should be>= 0
.- See Also:
-
setTextArea
Sets the text area being displayed. This will clear any tracking icons currently displayed.Most clients do not need to call this method directly. This is usually handled by `RTextScrollPane` directly.
- Parameters:
textArea
- The text area.
-
toggleBookmark
Programmatically toggles whether there is a bookmark for the specified line. If bookmarking is not enabled, this method does nothing.- Parameters:
line
- The line.- Returns:
- Whether a bookmark is now at the specified line.
- Throws:
BadLocationException
- Ifline
is an invalid line number in the text area.- See Also:
-
setBorder
- Overrides:
setBorder
in classJComponent
-