com.fr.design.gui.syntax.ui.rsyntaxtextarea

类 TextEditorPane

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.text.JTextComponent

javax.swing.JTextArea

com.fr.design.gui.syntax.ui.rtextarea.RTextArea

com.fr.design.gui.syntax.ui.rsyntaxtextarea.RSyntaxTextArea

com.fr.design.gui.syntax.ui.rsyntaxtextarea.TextEditorPane

所有已实现的接口:

SyntaxConstants, java.awt.image.ImageObserver, java.awt.MenuContainer, java.awt.print.Printable, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.DocumentListener, javax.swing.Scrollable

public class TextEditorPane
extends RSyntaxTextArea
implements javax.swing.event.DocumentListener

An extension of RSyntaxTextArea that adds information about the file being edited, such as:

• Its name and location.
• Is it dirty?
• Is it read-only?
• The last time it was loaded or saved to disk (local files only).
• The file's encoding on disk.
• Easy access to the line separator.

Loading and saving is also built into the editor.

Both local and remote files (e.g. ftp) are supported. See the FileLocation class for more information.

版本:

1.0

作者:

Robert Futrell

另请参阅:

FileLocation, 序列化表格

嵌套类概要

从类继承的嵌套类/接口 com.fr.design.gui.syntax.ui.rtextarea.RTextArea

RTextArea.RTextAreaMutableCaretEvent

从类继承的嵌套类/接口 javax.swing.JTextArea

javax.swing.JTextArea.AccessibleJTextArea

从类继承的嵌套类/接口 javax.swing.text.JTextComponent

javax.swing.text.JTextComponent.AccessibleJTextComponent, javax.swing.text.JTextComponent.DropLocation, javax.swing.text.JTextComponent.KeyBinding

从类继承的嵌套类/接口 javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

从类继承的嵌套类/接口 java.awt.Container

java.awt.Container.AccessibleAWTContainer

从类继承的嵌套类/接口 java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	BACKGROUND_IMAGE_PROPERTY
static java.lang.String	CURRENT_LINE_HIGHLIGHT_COLOR_PROPERTY
static java.lang.String	CURRENT_LINE_HIGHLIGHT_FADE_PROPERTY
static java.lang.String	DIRTY_PROPERTY
static java.lang.String	FULL_PATH_PROPERTY
static java.lang.String	HIGHLIGHT_CURRENT_LINE_PROPERTY
static long	LAST_MODIFIED_UNKNOWN The value returned by getLastSaveOrLoadTime() for remote files.
static java.lang.String	READ_ONLY_PROPERTY
static java.lang.String	ROUNDED_SELECTION_PROPERTY

从类继承的字段 com.fr.design.gui.syntax.ui.rsyntaxtextarea.RSyntaxTextArea

ANIMATE_BRACKET_MATCHING_PROPERTY, ANTIALIAS_PROPERTY, AUTO_INDENT_PROPERTY, BRACKET_MATCHING_PROPERTY, CLEAR_WHITESPACE_LINES_PROPERTY, CLOSE_CURLY_BRACES_PROPERTY, CLOSE_MARKUP_TAGS_PROPERTY, CODE_FOLDING_PROPERTY, EOL_VISIBLE_PROPERTY, FOCUSABLE_TIPS_PROPERTY, FRACTIONAL_FONTMETRICS_PROPERTY, HIGHLIGHT_SECONDARY_LANGUAGES_PROPERTY, HYPERLINKS_ENABLED_PROPERTY, MARK_OCCURRENCES_PROPERTY, MARKED_OCCURRENCES_CHANGED_PROPERTY, PAINT_MATCHED_BRACKET_PAIR_PROPERTY, PARSER_NOTICES_PROPERTY, SYNTAX_SCHEME_PROPERTY, SYNTAX_STYLE_PROPERTY, TAB_LINE_COLOR_PROPERTY, TAB_LINES_PROPERTY, USE_SELECTED_TEXT_COLOR_PROPERTY, VISIBLE_WHITESPACE_PROPERTY

从类继承的字段 com.fr.design.gui.syntax.ui.rtextarea.RTextArea

COPY_ACTION, CUT_ACTION, DELETE_ACTION, INSERT_MODE, MARK_ALL_COLOR_PROPERTY, MARK_ALL_OCCURRENCES_CHANGED_PROPERTY, OVERWRITE_MODE, PASTE_ACTION, REDO_ACTION, SELECT_ALL_ACTION, UNDO_ACTION

从类继承的字段 javax.swing.text.JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

从类继承的字段 javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

从类继承的字段 java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

从接口继承的字段 com.fr.design.gui.syntax.ui.rsyntaxtextarea.SyntaxConstants

SYNTAX_STYLE_ACTIONSCRIPT, SYNTAX_STYLE_ASSEMBLER_X86, SYNTAX_STYLE_BBCODE, SYNTAX_STYLE_C, SYNTAX_STYLE_CLOJURE, SYNTAX_STYLE_CPLUSPLUS, SYNTAX_STYLE_CSHARP, SYNTAX_STYLE_CSS, SYNTAX_STYLE_DELPHI, SYNTAX_STYLE_DTD, SYNTAX_STYLE_FORMULA, SYNTAX_STYLE_FORTRAN, SYNTAX_STYLE_GROOVY, SYNTAX_STYLE_HTACCESS, SYNTAX_STYLE_HTML, SYNTAX_STYLE_JAVA, SYNTAX_STYLE_JAVASCRIPT, SYNTAX_STYLE_JSON, SYNTAX_STYLE_JSP, SYNTAX_STYLE_LATEX, SYNTAX_STYLE_LISP, SYNTAX_STYLE_LUA, SYNTAX_STYLE_MAKEFILE, SYNTAX_STYLE_MXML, SYNTAX_STYLE_NONE, SYNTAX_STYLE_NSIS, SYNTAX_STYLE_PERL, SYNTAX_STYLE_PHP, SYNTAX_STYLE_PROPERTIES_FILE, SYNTAX_STYLE_PYTHON, SYNTAX_STYLE_RUBY, SYNTAX_STYLE_SAS, SYNTAX_STYLE_SCALA, SYNTAX_STYLE_SQL, SYNTAX_STYLE_TCL, SYNTAX_STYLE_UNIX_SHELL, SYNTAX_STYLE_VISUAL_BASIC, SYNTAX_STYLE_WINDOWS_BATCH, SYNTAX_STYLE_XML

从接口继承的字段 java.awt.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

从接口继承的字段 java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造器概要

构造器

构造器和说明
TextEditorPane() Constructor.
TextEditorPane(int textMode) Constructor.
TextEditorPane(int textMode, boolean wordWrapEnabled) Creates a new TextEditorPane.
TextEditorPane(int textMode, boolean wordWrapEnabled, FileLocation loc) Creates a new TextEditorPane.
TextEditorPane(int textMode, boolean wordWrapEnabled, FileLocation loc, java.lang.String defaultEnc) Creates a new TextEditorPane.

方法概要

方法

限定符和类型	方法和说明
void	changedUpdate(javax.swing.event.DocumentEvent e) Callback for when styles in the current document change.
void	convertSpacesToTabs() Converts all instances of a number of spaces equal to a tab size into a tab in this text area.
void	convertTabsToSpaces() Converts all instances of a tab into a number of spaces equivalent to a tab in this text area.
protected void	forceCurrentLineHighlightRepaint() Forces the current line highlight to be repainted.
java.awt.Color	getBackground() Returns the java.awt.Color used as the background color for this text area.
java.awt.Image	getBackgroundImage() Returns the image currently used for the background.
java.lang.Object	getBackgroundObject() Returns the Object representing the background for all documents in this tabbed pane; either a java.awt.Color or a java.lang.Image containing the image used as the background for this text area.
int	getCaretLineNumber() Gets the line number that the caret is on.
int	getCaretOffsetFromLineStart() Gets the position from the beginning of the current line that the caret is on.
java.awt.Color	getCurrentLineHighlightColor() Returns the color being used to highlight the current line.
static java.awt.Color	getDefaultCaretColor() Returns the default caret color.
static java.awt.Color	getDefaultCurrentLineHighlightColor() Returns the "default" color for highlighting the current line.
static java.awt.Font	getDefaultFont() Returns the default font for text areas.
static java.awt.Color	getDefaultForeground() Returns the default foreground color for text in this text area.
static java.awt.Color	getDefaultMarginLineColor() Returns the default color for the margin line.
static int	getDefaultMarginLinePosition() Returns the default margin line position.
static int	getDefaultTabSize() Returns the default tab size, in spaces.
java.lang.String	getEncoding() Returns the encoding to use when reading or writing this file.
boolean	getFadeCurrentLineHighlight() Returns whether the current line highlight is faded.
java.lang.String	getFileFullPath() Returns the full path to this document.
java.lang.String	getFileName() Returns the file name of this document.
boolean	getHighlightCurrentLine() Returns whether or not the current line is highlighted.
long	getLastSaveOrLoadTime() Returns the timestamp for when this file was last loaded or saved by this editor pane.
int	getLineEndOffsetOfCurrentLine() Returns the offset of the last character of the line that the caret is on.
java.lang.Object	getLineSeparator() Returns the line separator used when writing this file (e.g.
int	getLineStartOffsetOfCurrentLine() Returns the offset of the first character of the line that the caret is on.
java.awt.Color	getMarginLineColor() Returns the color used to paint the margin line.
int	getMarginLinePixelLocation() Returns the margin line position (in pixels) from the left-hand side of the text area.
int	getMarginLinePosition() Returns the margin line position (which is the number of 'm' widths in the current font the margin line is over).
boolean	getRoundedSelectionEdges() Returns whether selection edges are rounded in this text area.
boolean	getTabsEmulated() Returns whether or not tabs are emulated with spaces (i.e., "soft" tabs).
void	insertUpdate(javax.swing.event.DocumentEvent e) Callback for when text is inserted into the document.
boolean	isDirty() Returns whether or not the text in this editor has unsaved changes.
boolean	isLocal() Returns whether this file is a local file.
boolean	isLocalAndExists() Returns whether this is a local file that already exists.
boolean	isMarginLineEnabled() Returns whether or not the margin line is being painted.
boolean	isModifiedOutsideEditor() Returns whether the text file has been modified outside of this editor since the last load or save operation.
static boolean	isOSX() Returns whether the OS we're running on is OS X.
boolean	isReadOnly() Returns whether or not the text area should be treated as read-only.
void	load(FileLocation loc, java.lang.String defaultEnc) Loads the specified file in this editor.
protected void	possiblyUpdateCurrentLineHighlightLocation() Updates the current line highlight location.
protected void	processComponentEvent(java.awt.event.ComponentEvent e) Overridden so we can tell when the text area is resized and update the current-line highlight, if necessary (i.e., if it is enabled and if lineWrap is enabled.
void	reload() Reloads this file from disk.
void	removeUpdate(javax.swing.event.DocumentEvent e) Called whenever text is removed from this editor.
void	save() Saves the file in its current encoding.
void	saveAs(FileLocation loc) Saves this file in a new local location.
void	setBackground(java.awt.Color bg) Sets the background color of this text editor.
void	setBackgroundImage(java.awt.Image image) Sets this image as the background image.
void	setBackgroundObject(java.lang.Object newBackground) Makes the background into this Object.
void	setCurrentLineHighlightColor(java.awt.Color color) Sets the color to use to highlight the current line.
void	setDirty(boolean dirty) Sets whether or not this text in this editor has unsaved changes.
void	setDocument(javax.swing.text.Document doc) Sets the document for this editor.
void	setEncoding(java.lang.String encoding) Sets the encoding to use when reading or writing this file.
void	setFadeCurrentLineHighlight(boolean fade) Sets whether the current line highlight should have a "fade" effect.
void	setHighlightCurrentLine(boolean highlight) Sets whether or not the current line is highlighted.
void	setLineSeparator(java.lang.String separator) Sets the line separator sequence to use when this file is saved (e.g.
void	setLineSeparator(java.lang.String separator, boolean setDirty) Sets the line separator sequence to use when this file is saved (e.g.
void	setLineWrap(boolean wrap) Sets whether or not word wrap is enabled.
void	setMargin(java.awt.Insets insets) Overridden to update the current line highlight location.
void	setMarginLineColor(java.awt.Color color) Sets the color used to paint the margin line.
void	setMarginLineEnabled(boolean enabled) Enables or disables the margin line.
void	setMarginLinePosition(int size) Sets the number of 'm' widths the margin line is over.
void	setReadOnly(boolean readOnly) Sets whether or not this text area should be treated as read-only.
protected void	setRTextAreaUI(RTextAreaUI ui) Sets the UI for this RTextArea.
void	setTabsEmulated(boolean areEmulated) Changes whether or not tabs should be emulated with spaces (i.e., soft tabs).
void	setTabSize(int size) Workaround, since in JDK1.4 it appears that setTabSize() doesn't work for a JTextArea unless you use the constructor specifying the number of rows and columns...
void	syncLastSaveOrLoadTimeToActualFile() Syncs this text area's "last saved or loaded" time to that of the file being edited, if that file is local and exists.
protected void	updateMarginLineX() This is here so subclasses such as RSyntaxTextArea that have multiple fonts can define exactly what it means, for example, for the margin line to be "80 characters" over.
int	yForLine(int line) Returns the y-coordinate of the specified line.
int	yForLineContaining(int offs) Returns the y-coordinate of the line containing an offset.

从类继承的方法 com.fr.design.gui.syntax.ui.rsyntaxtextarea.RSyntaxTextArea

addActiveLineRangeListener, addHyperlinkListener, addNotify, addParser, appendFoldingMenu, clearParsers, configurePopupMenu, copyAsRtf, createDefaultModel, createMouseListener, createPopupMenu, createRTextAreaUI, doBracketMatching, fireCaretUpdate, foldToggled, forceReparsing, forceReparsing, getAnimateBracketMatching, getAntiAliasingEnabled, getBackgroundForToken, getCloseCurlyBraces, getCloseMarkupTags, getCodeTemplateManager, getDefaultBracketMatchBGColor, getDefaultBracketMatchBorderColor, getDefaultSelectionColor, getDefaultSyntaxScheme, getEOLMarkersVisible, getFoldManager, getFontForTokenType, getFontMetricsForTokenType, getForegroundForToken, getForegroundForTokenType, getFractionalFontMetricsEnabled, getHighlightSecondaryLanguages, getHyperlinkForeground, getHyperlinksEnabled, getLastVisibleOffset, getLineHeight, getLinkGenerator, getMarkAllHighlightRanges, getMarkedOccurrences, getMarkOccurrences, getMarkOccurrencesColor, getMatchedBracketBGColor, getMatchedBracketBorderColor, getMaxAscent, getPaintMarkOccurrencesBorder, getPaintMatchedBracketPair, getPaintTabLines, getParser, getParserCount, getParserNotices, getRightHandSideCorrection, getSecondaryLanguageBackground, getSecondaryLanguageCount, getShouldIndentNextLine, getSyntaxEditingStyle, getSyntaxScheme, getTabLineColor, getTemplatesEnabled, getTokenListForLine, getToolTipText, getUnderlineForToken, getUseFocusableTips, getUseSelectedTextColor, init, isAutoIndentEnabled, isBracketMatchingEnabled, isClearWhitespaceLinesEnabled, isCodeFoldingEnabled, isWhitespaceVisible, modelToToken, paintComponent, removeActiveLineRangeListener, removeHyperlinkListener, removeNotify, removeParser, restoreDefaultSyntaxScheme, saveTemplates, setActiveLineRange, setAnimateBracketMatching, setAntiAliasingEnabled, setAutoIndentEnabled, setBracketMatchingEnabled, setClearWhitespaceLinesEnabled, setCloseCurlyBraces, setCloseMarkupTags, setCodeFoldingEnabled, setEOLMarkersVisible, setFont, setFractionalFontMetricsEnabled, setHighlighter, setHighlightSecondaryLanguages, setHyperlinkForeground, setHyperlinksEnabled, setLinkGenerator, setLinkScanningMask, setMarkOccurrences, setMarkOccurrencesColor, setMatchedBracketBGColor, setMatchedBracketBorderColor, setPaintMarkOccurrencesBorder, setPaintMatchedBracketPair, setPaintTabLines, setRightHandSideCorrection, setSecondaryLanguageBackground, setSyntaxEditingStyle, setSyntaxScheme, setTabLineColor, setTemplateDirectory, setTemplatesEnabled, setUseFocusableTips, setUseSelectedTextColor, setWhitespaceVisible, viewToToken

从类继承的方法 com.fr.design.gui.syntax.ui.rtextarea.RTextArea

addLineHighlight, beginAtomicEdit, beginRecordingMacro, canRedo, canUndo, createPopupMenuItem, createUndoManager, discardAllEdits, endAtomicEdit, endRecordingMacro, getAction, getCurrentMacro, getDefaultMarkAllHighlightColor, getIconGroup, getMarkAllHighlightColor, getPopupMenu, getSelectedOccurrenceText, getTextMode, getToolTipSupplier, handleReplaceSelection, isRecordingMacro, loadMacro, paste, playbackLastMacro, print, read, redoLastAction, removeAllLineHighlights, removeLineHighlight, replaceRange, replaceSelection, setActionProperties, setActionProperties, setCaret, setCaretStyle, setIconGroup, setMarkAllHighlightColor, setPopupMenu, setRoundedSelectionEdges, setSelectedOccurrenceText, setTextMode, setToolTipSupplier, setUI, undoLastAction

从类继承的方法 javax.swing.JTextArea

append, getAccessibleContext, getColumns, getColumnWidth, getLineCount, getLineEndOffset, getLineOfOffset, getLineStartOffset, getLineWrap, getPreferredScrollableViewportSize, getPreferredSize, getRowHeight, getRows, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getTabSize, getUIClassID, getWrapStyleWord, insert, paramString, setColumns, setRows, setWrapStyleWord

从类继承的方法 javax.swing.text.JTextComponent

addCaretListener, addInputMethodListener, addKeymap, copy, cut, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, print, print, print, processInputMethodEvent, removeCaretListener, removeKeymap, restoreComposedText, saveComposedText, select, selectAll, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setKeymap, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, updateUI, viewToModel, write

从类继承的方法 javax.swing.JComponent

addAncestorListener, 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, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

从类继承的方法 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

从类继承的方法 java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细资料

FULL_PATH_PROPERTY

public static final java.lang.String FULL_PATH_PROPERTY

另请参阅:

常量字段值

DIRTY_PROPERTY

public static final java.lang.String DIRTY_PROPERTY

另请参阅:

常量字段值

READ_ONLY_PROPERTY

public static final java.lang.String READ_ONLY_PROPERTY

另请参阅:

常量字段值

LAST_MODIFIED_UNKNOWN

public static final long LAST_MODIFIED_UNKNOWN

The value returned by getLastSaveOrLoadTime() for remote files.

另请参阅:

常量字段值

BACKGROUND_IMAGE_PROPERTY

public static final java.lang.String BACKGROUND_IMAGE_PROPERTY

另请参阅:

常量字段值

CURRENT_LINE_HIGHLIGHT_COLOR_PROPERTY

public static final java.lang.String CURRENT_LINE_HIGHLIGHT_COLOR_PROPERTY

另请参阅:

常量字段值

CURRENT_LINE_HIGHLIGHT_FADE_PROPERTY

public static final java.lang.String CURRENT_LINE_HIGHLIGHT_FADE_PROPERTY

另请参阅:

常量字段值

HIGHLIGHT_CURRENT_LINE_PROPERTY

public static final java.lang.String HIGHLIGHT_CURRENT_LINE_PROPERTY

另请参阅:

常量字段值

ROUNDED_SELECTION_PROPERTY

public static final java.lang.String ROUNDED_SELECTION_PROPERTY

另请参阅:

常量字段值

构造器详细资料

TextEditorPane

public TextEditorPane()

Constructor. The file will be given a default name.

TextEditorPane

public TextEditorPane(int textMode)

Constructor. The file will be given a default name.

参数:

textMode - Either INSERT_MODE or OVERWRITE_MODE.

TextEditorPane

public TextEditorPane(int textMode,
              boolean wordWrapEnabled)

Creates a new TextEditorPane. The file will be given a default name.

参数:

textMode - Either INSERT_MODE or OVERWRITE_MODE.

wordWrapEnabled - Whether or not to use word wrap in this pane.

TextEditorPane

public TextEditorPane(int textMode,
              boolean wordWrapEnabled,
              FileLocation loc)
               throws java.io.IOException

Creates a new TextEditorPane.

参数:

textMode - Either INSERT_MODE or OVERWRITE_MODE.

wordWrapEnabled - Whether or not to use word wrap in this pane.

loc - The location of the text file being edited. If this value is null, a file named "Untitled.txt" in the current directory is used.

抛出:

java.io.IOException - If an IO error occurs reading the file at loc. This of course won't happen if loc is null.

TextEditorPane

public TextEditorPane(int textMode,
              boolean wordWrapEnabled,
              FileLocation loc,
              java.lang.String defaultEnc)
               throws java.io.IOException

Creates a new TextEditorPane.

参数:

textMode - Either INSERT_MODE or OVERWRITE_MODE.

wordWrapEnabled - Whether or not to use word wrap in this pane.

loc - The location of the text file being edited. If this value is null, a file named "Untitled.txt" in the current directory is used. This file is displayed as empty even if it actually exists.

defaultEnc - The default encoding to use when opening the file, if the file is not Unicode. If this value is null, a system default value is used.

抛出:

java.io.IOException - If an IO error occurs reading the file at loc. This of course won't happen if loc is null.

方法详细资料

changedUpdate

public void changedUpdate(javax.swing.event.DocumentEvent e)

Callback for when styles in the current document change. This method is never called.

指定者:

changedUpdate 在接口中 javax.swing.event.DocumentListener

参数:

e - The document event.

getEncoding

public java.lang.String getEncoding()

Returns the encoding to use when reading or writing this file.

返回:

The encoding.

另请参阅:

setEncoding(String)

getFileFullPath

public java.lang.String getFileFullPath()

Returns the full path to this document.

返回:

The full path to the document.

getFileName

public java.lang.String getFileName()

Returns the file name of this document.

返回:

The file name.

getLastSaveOrLoadTime

public long getLastSaveOrLoadTime()

Returns the timestamp for when this file was last loaded or saved by this editor pane. If the file has been modified on disk by another process after it was loaded into this editor pane, this method will not return the actual file's last modified time.

For remote files, this method will always return LAST_MODIFIED_UNKNOWN.

返回:

The timestamp when this file was last loaded or saved by this editor pane, if it is a local file, or LAST_MODIFIED_UNKNOWN if it is a remote file.

另请参阅:

isModifiedOutsideEditor()

getLineSeparator

public java.lang.Object getLineSeparator()

Returns the line separator used when writing this file (e.g. "\n", "\r\n", or "\r").

Note that this value is an Object and not a String as that is the way the Document interface defines its property values. If you always use setLineSeparator(String) to modify this value, then the value returned from this method will always be a String.

返回:

The line separator. If this value is null, then the system default line separator is used (usually the value of System.getProperty("line.separator")).

另请参阅:

setLineSeparator(String), setLineSeparator(String, boolean)

insertUpdate

public void insertUpdate(javax.swing.event.DocumentEvent e)

Callback for when text is inserted into the document.

指定者:

insertUpdate 在接口中 javax.swing.event.DocumentListener

参数:

e - Information on the insertion.

isDirty

public boolean isDirty()

Returns whether or not the text in this editor has unsaved changes.

返回:

Whether or not the text has unsaved changes.

另请参阅:

setDirty(boolean)

isLocal

public boolean isLocal()

Returns whether this file is a local file.

返回:

Whether this is a local file.

isLocalAndExists

public boolean isLocalAndExists()

Returns whether this is a local file that already exists.

返回:

Whether this is a local file that already exists.

isModifiedOutsideEditor

public boolean isModifiedOutsideEditor()

Returns whether the text file has been modified outside of this editor since the last load or save operation. Note that if this is a remote file, this method will always return false.

This method may be used by applications to implement a reloading feature, where the user is prompted to reload a file if it has been modified since their last open or save.

返回:

Whether the text file has been modified outside of this editor.

另请参阅:

getLastSaveOrLoadTime()

isReadOnly

public boolean isReadOnly()

Returns whether or not the text area should be treated as read-only.

返回:

Whether or not the text area should be treated as read-only.

另请参阅:

setReadOnly(boolean)

load

public void load(FileLocation loc,
        java.lang.String defaultEnc)
          throws java.io.IOException

Loads the specified file in this editor. This method fires a property change event of type FULL_PATH_PROPERTY.

参数:

loc - The location of the file to load. This cannot be null.

defaultEnc - The encoding to use when loading/saving the file. This encoding will only be used if the file is not Unicode. If this value is null, the system default encoding is used.

抛出:

java.io.IOException - If an IO error occurs.

另请参阅:

save(), saveAs(FileLocation)

reload

public void reload()
            throws java.io.IOException

Reloads this file from disk. The file must exist for this operation to not throw an exception.

The file's "dirty" state will be set to false after this operation. If this is a local file, its "last modified" time is updated to reflect that of the actual file.

Note that if the file has been modified on disk, and is now a Unicode encoding when before it wasn't (or if it is a different Unicode now), this will cause this TextEditorPane's encoding to change. Otherwise, the file's encoding will stay the same.

抛出:

java.io.IOException - If the file does not exist, or if an IO error occurs reading the file.

另请参阅:

isLocalAndExists()

removeUpdate

public void removeUpdate(javax.swing.event.DocumentEvent e)

Called whenever text is removed from this editor.

指定者:

removeUpdate 在接口中 javax.swing.event.DocumentListener

参数:

e - The document event.

save

public void save()
          throws java.io.IOException

Saves the file in its current encoding.

The text area's "dirty" state is set to false, and if this is a local file, its "last modified" time is updated.

抛出:

java.io.IOException - If an IO error occurs.

另请参阅:

saveAs(FileLocation), load(FileLocation, String)

saveAs

public void saveAs(FileLocation loc)
            throws java.io.IOException

Saves this file in a new local location. This method fires a property change event of type FULL_PATH_PROPERTY.

参数:

loc - The location to save to.

抛出:

java.io.IOException - If an IO error occurs.

另请参阅:

save(), load(FileLocation, String)

setDirty

public void setDirty(boolean dirty)

Sets whether or not this text in this editor has unsaved changes. This fires a property change event of type DIRTY_PROPERTY.

Applications will usually have no need to call this method directly; the only time you might have a need to call this method directly is if you have to initialize an instance of TextEditorPane with content that does not come from a file. TextEditorPane automatically sets its own dirty flag when its content is edited, when its encoding is changed, or when its line ending property is changed. It is cleared whenever load(), reload(), save(), or saveAs() are called.

参数:

dirty - Whether or not the text has been modified.

另请参阅:

isDirty()

setDocument

public void setDocument(javax.swing.text.Document doc)

Sets the document for this editor.

覆盖:

setDocument 在类中 RSyntaxTextArea

参数:

doc - The new document.

setEncoding

public void setEncoding(java.lang.String encoding)

Sets the encoding to use when reading or writing this file. This method sets the editor's dirty flag when the encoding is changed.

参数:

encoding - The new encoding.

抛出:

java.nio.charset.UnsupportedCharsetException - If the encoding is not supported.

java.lang.NullPointerException - If encoding is null.

另请参阅:

getEncoding()

setLineSeparator

public void setLineSeparator(java.lang.String separator)

Sets the line separator sequence to use when this file is saved (e.g. "\n", "\r\n" or "\r"). Besides parameter checking, this method is preferred over getDocument().putProperty() because it sets the editor's dirty flag when the line separator is changed.

参数:

separator - The new line separator.

抛出:

java.lang.NullPointerException - If separator is null.

java.lang.IllegalArgumentException - If separator is not one of "\n", "\r\n" or "\r".

另请参阅:

getLineSeparator()

setLineSeparator

public void setLineSeparator(java.lang.String separator,
                    boolean setDirty)

Sets the line separator sequence to use when this file is saved (e.g. "\n", "\r\n" or "\r"). Besides parameter checking, this method is preferred over getDocument().putProperty() because can set the editor's dirty flag when the line separator is changed.

参数:

separator - The new line separator.

setDirty - Whether the dirty flag should be set if the line separator is changed.

抛出:

java.lang.NullPointerException - If separator is null.

java.lang.IllegalArgumentException - If separator is not one of "\n", "\r\n" or "\r".

另请参阅:

getLineSeparator()

setReadOnly

public void setReadOnly(boolean readOnly)

Sets whether or not this text area should be treated as read-only. This fires a property change event of type READ_ONLY_PROPERTY.

参数:

readOnly - Whether or not the document is read-only.

另请参阅:

isReadOnly()

syncLastSaveOrLoadTimeToActualFile

public void syncLastSaveOrLoadTimeToActualFile()

Syncs this text area's "last saved or loaded" time to that of the file being edited, if that file is local and exists. If the file is remote or is local but does not yet exist, nothing happens.

You normally do not have to call this method, as the "last saved or loaded" time for TextEditorPanes is kept up-to-date internally during such operations as save(), reload(), etc.

另请参阅:

getLastSaveOrLoadTime(), isModifiedOutsideEditor()

convertSpacesToTabs

public void convertSpacesToTabs()

Converts all instances of a number of spaces equal to a tab size into a tab in this text area.

另请参阅:

convertTabsToSpaces(), getTabsEmulated(), setTabsEmulated(boolean)

convertTabsToSpaces

public void convertTabsToSpaces()

Converts all instances of a tab into a number of spaces equivalent to a tab in this text area.

另请参阅:

convertSpacesToTabs(), getTabsEmulated(), setTabsEmulated(boolean)

forceCurrentLineHighlightRepaint

protected void forceCurrentLineHighlightRepaint()

Forces the current line highlight to be repainted. This hack is necessary for those situations when the view (appearance) changes but the caret's location hasn't (and thus the current line highlight coordinates won't get changed). Examples of this are when word wrap is toggled and when syntax styles are changed in an RSyntaxTextArea.

getBackground

public final java.awt.Color getBackground()

Returns the java.awt.Color used as the background color for this text area. If a java.awt.Image image is currently being used instead, null is returned.

覆盖:

getBackground 在类中 java.awt.Component

返回:

The current background color, or null if an image is currently the background.

getBackgroundImage

public final java.awt.Image getBackgroundImage()

Returns the image currently used for the background. If the current background is currently a java.awt.Color and not a java.awt.Image, then null is returned.

返回:

A java.awt.Image used for the background, or null if the background is not an image.

另请参阅:

setBackgroundImage(java.awt.Image)

getBackgroundObject

public final java.lang.Object getBackgroundObject()

Returns the Object representing the background for all documents in this tabbed pane; either a java.awt.Color or a java.lang.Image containing the image used as the background for this text area.

返回:

The Object used for the background.

另请参阅:

setBackgroundObject(Object newBackground)

getCaretLineNumber

public final int getCaretLineNumber()

Gets the line number that the caret is on.

返回:

The zero-based line number that the caret is on.

getCaretOffsetFromLineStart

public final int getCaretOffsetFromLineStart()

Gets the position from the beginning of the current line that the caret is on.

返回:

The zero-based position from the beginning of the current line that the caret is on.

getCurrentLineHighlightColor

public java.awt.Color getCurrentLineHighlightColor()

Returns the color being used to highlight the current line. Note that if highlighting the current line is turned off, you will not be seeing this highlight.

返回:

The color being used to highlight the current line.

另请参阅:

getHighlightCurrentLine(), setHighlightCurrentLine(boolean), setCurrentLineHighlightColor(java.awt.Color)

getDefaultCaretColor

public static final java.awt.Color getDefaultCaretColor()

Returns the default caret color.

返回:

The default caret color.

getDefaultCurrentLineHighlightColor

public static final java.awt.Color getDefaultCurrentLineHighlightColor()

Returns the "default" color for highlighting the current line. Note that this color was chosen only because it looks nice (to me) against a white background.

返回:

The default color for highlighting the current line.

getDefaultFont

public static final java.awt.Font getDefaultFont()

Returns the default font for text areas.

返回:

The default font.

getDefaultForeground

public static final java.awt.Color getDefaultForeground()

Returns the default foreground color for text in this text area.

返回:

The default foreground color.

getDefaultMarginLineColor

public static final java.awt.Color getDefaultMarginLineColor()

Returns the default color for the margin line.

返回:

The default margin line color.

另请参阅:

getMarginLineColor(), setMarginLineColor(Color)

getDefaultMarginLinePosition

public static final int getDefaultMarginLinePosition()

Returns the default margin line position.

返回:

The default margin line position.

另请参阅:

getMarginLinePosition(), setMarginLinePosition(int)

getDefaultTabSize

public static final int getDefaultTabSize()

Returns the default tab size, in spaces.

返回:

The default tab size.

getFadeCurrentLineHighlight

public boolean getFadeCurrentLineHighlight()

Returns whether the current line highlight is faded.

返回:

Whether the current line highlight is faded.

另请参阅:

setFadeCurrentLineHighlight(boolean)

getHighlightCurrentLine

public boolean getHighlightCurrentLine()

Returns whether or not the current line is highlighted.

返回:

Whether or the current line is highlighted.

另请参阅:

setHighlightCurrentLine(boolean), getCurrentLineHighlightColor(), setCurrentLineHighlightColor(java.awt.Color)

getLineEndOffsetOfCurrentLine

public final int getLineEndOffsetOfCurrentLine()

Returns the offset of the last character of the line that the caret is on.

返回:

The last offset of the line that the caret is currently on.

getLineStartOffsetOfCurrentLine

public final int getLineStartOffsetOfCurrentLine()

Returns the offset of the first character of the line that the caret is on.

返回:

The first offset of the line that the caret is currently on.

getMarginLineColor

public java.awt.Color getMarginLineColor()

Returns the color used to paint the margin line.

返回:

The margin line color.

另请参阅:

setMarginLineColor(Color)

getMarginLinePixelLocation

public int getMarginLinePixelLocation()

Returns the margin line position (in pixels) from the left-hand side of the text area.

返回:

The margin line position.

另请参阅:

getDefaultMarginLinePosition(), setMarginLinePosition(int)

getMarginLinePosition

public int getMarginLinePosition()

Returns the margin line position (which is the number of 'm' widths in the current font the margin line is over).

返回:

The margin line position.

另请参阅:

getDefaultMarginLinePosition(), setMarginLinePosition(int)

getRoundedSelectionEdges

public boolean getRoundedSelectionEdges()

Returns whether selection edges are rounded in this text area.

返回:

Whether selection edges are rounded.

另请参阅:

setRoundedSelectionEdges(boolean)

getTabsEmulated

public boolean getTabsEmulated()

Returns whether or not tabs are emulated with spaces (i.e., "soft" tabs).

返回:

true if tabs are emulated with spaces; false if they aren't.

另请参阅:

setTabsEmulated(boolean)

isMarginLineEnabled

public boolean isMarginLineEnabled()

Returns whether or not the margin line is being painted.

返回:

Whether or not the margin line is being painted.

另请参阅:

setMarginLineEnabled(boolean)

isOSX

public static boolean isOSX()

Returns whether the OS we're running on is OS X.

返回:

Whether the OS we're running on is OS X.

possiblyUpdateCurrentLineHighlightLocation

protected void possiblyUpdateCurrentLineHighlightLocation()

Updates the current line highlight location.

processComponentEvent

protected void processComponentEvent(java.awt.event.ComponentEvent e)

Overridden so we can tell when the text area is resized and update the current-line highlight, if necessary (i.e., if it is enabled and if lineWrap is enabled.

覆盖:

processComponentEvent 在类中 java.awt.Component

参数:

e - The component event about to be sent to all registered ComponentListeners.

setBackground

public void setBackground(java.awt.Color bg)

Sets the background color of this text editor. Note that this is equivalent to calling setBackgroundObject(bg). NOTE: the opaque property is set to true when the background is set to a color (by this method). When an image is used for the background, opaque is set to false. This is because we perform better when setOpaque is true, but if we use an image for the background when opaque is true, we get on-screen garbage when the user scrolls via the arrow keys. Thus we need setOpaque to be false in that case.

You never have to change the opaque property yourself; it is always done for you.

覆盖:

setBackground 在类中 javax.swing.JComponent

参数:

bg - The color to use as the background color.

setBackgroundImage

public void setBackgroundImage(java.awt.Image image)

Sets this image as the background image. This method fires a property change event of type BACKGROUND_IMAGE_PROPERTY.

NOTE: the opaque property is set to true when the background is set to a color. When an image is used for the background (by this method), opaque is set to false. This is because we perform better when setOpaque is true, but if we use an image for the background when opaque is true, we get on-screen garbage when the user scrolls via the arrow keys. Thus we need setOpaque to be false in that case.

You never have to change the opaque property yourself; it is always done for you.

参数:

image - The image to use as this text area's background.

另请参阅:

getBackgroundImage()

setBackgroundObject

public void setBackgroundObject(java.lang.Object newBackground)

Makes the background into this Object.

参数:

newBackground - The java.awt.Color or java.awt.Image object. If newBackground is not either of these, the background is set to plain white.

setCurrentLineHighlightColor

public void setCurrentLineHighlightColor(java.awt.Color color)

Sets the color to use to highlight the current line. Note that if highlighting the current line is turned off, you will not be able to see this highlight. This method fires a property change of type CURRENT_LINE_HIGHLIGHT_COLOR_PROPERTY.

参数:

color - The color to use to highlight the current line.

抛出:

java.lang.NullPointerException - if color is null.

另请参阅:

getHighlightCurrentLine(), setHighlightCurrentLine(boolean), getCurrentLineHighlightColor()

setFadeCurrentLineHighlight

public void setFadeCurrentLineHighlight(boolean fade)

Sets whether the current line highlight should have a "fade" effect. This method fires a property change event of type CURRENT_LINE_HIGHLIGHT_FADE_PROPERTY.

参数:

fade - Whether the fade effect should be enabled.

另请参阅:

getFadeCurrentLineHighlight()

setHighlightCurrentLine

public void setHighlightCurrentLine(boolean highlight)

Sets whether or not the current line is highlighted. This method fires a property change of type HIGHLIGHT_CURRENT_LINE_PROPERTY.

参数:

highlight - Whether or not to highlight the current line.

另请参阅:

getHighlightCurrentLine(), getCurrentLineHighlightColor(), setCurrentLineHighlightColor(java.awt.Color)

setLineWrap

public void setLineWrap(boolean wrap)

Sets whether or not word wrap is enabled. This is overridden so that the "current line highlight" gets updated if it needs to be.

覆盖:

setLineWrap 在类中 javax.swing.JTextArea

参数:

wrap - Whether or not word wrap should be enabled.

setMargin

public void setMargin(java.awt.Insets insets)

Overridden to update the current line highlight location.

覆盖:

setMargin 在类中 javax.swing.text.JTextComponent

参数:

insets - The new insets.

setMarginLineColor

public void setMarginLineColor(java.awt.Color color)

Sets the color used to paint the margin line.

参数:

color - The new margin line color.

另请参阅:

getDefaultMarginLineColor(), getMarginLineColor()

setMarginLineEnabled

public void setMarginLineEnabled(boolean enabled)

Enables or disables the margin line.

参数:

enabled - Whether or not the margin line should be enabled.

另请参阅:

isMarginLineEnabled()

setMarginLinePosition

public void setMarginLinePosition(int size)

Sets the number of 'm' widths the margin line is over.

参数:

size - The margin size. #see #getDefaultMarginLinePosition

另请参阅:

getMarginLinePosition()

setRTextAreaUI

protected void setRTextAreaUI(RTextAreaUI ui)

Sets the UI for this RTextArea. Note that, for instances of RTextArea, setUI only updates the popup menu; this is because RTextAreas' look and feels are independent of the Java Look and Feel. This method is here so subclasses can set a UI (subclass of RTextAreaUI) if they have to.

参数:

ui - The new UI.

另请参阅:

JTextComponent.setUI(javax.swing.plaf.TextUI)

setTabsEmulated

public void setTabsEmulated(boolean areEmulated)

Changes whether or not tabs should be emulated with spaces (i.e., soft tabs). Note that this affects all tabs inserted AFTER this call, not tabs already in the document. For that, see convertTabsToSpaces() and convertSpacesToTabs().

参数:

areEmulated - Whether or not tabs should be emulated with spaces.

另请参阅:

convertSpacesToTabs(), convertTabsToSpaces(), getTabsEmulated()

setTabSize

public void setTabSize(int size)

Workaround, since in JDK1.4 it appears that setTabSize() doesn't work for a JTextArea unless you use the constructor specifying the number of rows and columns...

Sets the number of characters to expand tabs to. This will be multiplied by the maximum advance for variable width fonts. A PropertyChange event ("tabSize") is fired when the tab size changes.

覆盖:

setTabSize 在类中 javax.swing.JTextArea

参数:

size - Number of characters to expand to.

updateMarginLineX

protected void updateMarginLineX()

This is here so subclasses such as RSyntaxTextArea that have multiple fonts can define exactly what it means, for example, for the margin line to be "80 characters" over.

yForLine

public int yForLine(int line)
             throws javax.swing.text.BadLocationException

Returns the y-coordinate of the specified line.

参数:

line - The line number.

返回:

The y-coordinate of the top of the line, or -1 if this text area doesn't yet have a positive size or the line is hidden (i.e. from folding).

抛出:

javax.swing.text.BadLocationException - If line isn't a valid line number for this document.

yForLineContaining

public int yForLineContaining(int offs)
                       throws javax.swing.text.BadLocationException

Returns the y-coordinate of the line containing an offset.

参数:

offs - The offset info the document.

返回:

The y-coordinate of the top of the offset, or -1 if this text area doesn't yet have a positive size or the line is hidden (i.e. from folding).

抛出:

javax.swing.text.BadLocationException - If offs isn't a valid offset into the document.