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

类 RSyntaxDocument

java.lang.Object

javax.swing.text.AbstractDocument

javax.swing.text.PlainDocument

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

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

所有已实现的接口:

SyntaxConstants, java.io.Serializable, java.lang.Iterable<Token>, javax.swing.text.Document

public class RSyntaxDocument
extends RDocument
implements java.lang.Iterable<Token>, SyntaxConstants

The document used by RSyntaxTextArea. This document is like javax.swing.text.PlainDocument except that it also keeps track of syntax highlighting in the document. It has a "style" attribute associated with it that determines how syntax highlighting is done (i.e., what language is being highlighted).

Instances of RSyntaxTextArea will only accept instances of RSyntaxDocument, since it is this document that keeps track of syntax highlighting. All others will cause an exception to be thrown.

To change the language being syntax highlighted at any time, you merely have to call setSyntaxStyle(java.lang.String). Other than that, this document can be treated like any other save one caveat: all DocumentEvents of type CHANGE use their offset and length values to represent the first and last lines, respectively, that have had their syntax coloring change. This is really a hack to increase the speed of the painting code and should really be corrected, but oh well.

版本:

1.0

作者:

Robert Futrell

另请参阅:

序列化表格

嵌套类概要

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

javax.swing.text.AbstractDocument.AbstractElement, javax.swing.text.AbstractDocument.AttributeContext, javax.swing.text.AbstractDocument.BranchElement, javax.swing.text.AbstractDocument.Content, javax.swing.text.AbstractDocument.DefaultDocumentEvent, javax.swing.text.AbstractDocument.ElementEdit, javax.swing.text.AbstractDocument.LeafElement

字段概要

字段

限定符和类型	字段和说明
protected DynamicIntArray	lastTokensOnLines Array of values representing the "last token type" on each line.

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

lineLimitAttribute, tabSizeAttribute

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

BAD_LOCATION, BidiElementName, ContentElementName, ElementNameAttribute, listenerList, ParagraphElementName, SectionElementName

从接口继承的字段 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

从接口继承的字段 javax.swing.text.Document

StreamDescriptionProperty, TitleProperty

构造器概要

构造器

构造器和说明
RSyntaxDocument(java.lang.String syntaxStyle) Constructs a plain text document.
RSyntaxDocument(TokenMakerFactory tmf, java.lang.String syntaxStyle) Constructs a plain text document.

方法概要

方法

限定符和类型	方法和说明
protected void	fireInsertUpdate(javax.swing.event.DocumentEvent e) Alerts all listeners to this document of an insertion.
protected void	fireRemoveUpdate(javax.swing.event.DocumentEvent chng) This method is called AFTER the content has been inserted into the document and the element structure has been updated.
int	getClosestStandardTokenTypeForInternalType(int type) Returns the closest "standard" token type for a given "internal" token type (e.g. one whose value is < 0).
boolean	getCompleteMarkupCloseTags() Returns whether closing markup tags should be automatically completed.
boolean	getCurlyBracesDenoteCodeBlocks() Returns whether the current programming language uses curly braces ('{' and '}') to denote code blocks.
boolean	getLanguageIsMarkup() Returns whether the current language is a markup language, such as HTML, XML or PHP.
int	getLastTokenTypeOnLine(int line) Returns the token type of the last token on the given line.
java.lang.String[]	getLineCommentStartAndEnd() Returns the text to place at the beginning and end of a line to "comment" it in the current programming language.
boolean	getShouldIndentNextLine(int line) This method returns whether auto indentation should be done if Enter is pressed at the end of the specified line.
Token	getTokenListForLine(int line) Returns a token list for the specified segment of text representing the specified line number.
java.util.Iterator<Token>	iterator() Returns an iterator over the tokens in this document.
void	setSyntaxStyle(java.lang.String styleKey) Sets the syntax style being used for syntax highlighting in this document.
void	setSyntaxStyle(TokenMaker tokenMaker) Sets the syntax style being used for syntax highlighting in this document.
void	setTokenMakerFactory(TokenMakerFactory tmf) Sets the token maker factory used by this document.
protected void	updateSyntaxHighlightingInformation() Updates internal state information; e.g. the "last tokens on lines" data.

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

charAt

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

createDefaultRoot, getDefaultRootElement, getParagraphElement, insertString, insertUpdate, removeUpdate

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

addDocumentListener, addUndoableEditListener, createBranchElement, createLeafElement, createPosition, dump, fireChangedUpdate, fireUndoableEditUpdate, getAsynchronousLoadPriority, getAttributeContext, getBidiRootElement, getContent, getCurrentWriter, getDocumentFilter, getDocumentListeners, getDocumentProperties, getEndPosition, getLength, getListeners, getProperty, getRootElements, getStartPosition, getText, getText, getUndoableEditListeners, postRemoveUpdate, putProperty, readLock, readUnlock, remove, removeDocumentListener, removeUndoableEditListener, render, replace, setAsynchronousLoadPriority, setDocumentFilter, setDocumentProperties, writeLock, writeUnlock

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

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

字段详细资料

lastTokensOnLines

protected transient DynamicIntArray lastTokensOnLines

Array of values representing the "last token type" on each line. This is used in cases such as multi-line comments: if the previous line ended with an (unclosed) multi-line comment, we can use this knowledge and start the current line's syntax highlighting in multi-line comment state.

构造器详细资料

RSyntaxDocument

public RSyntaxDocument(java.lang.String syntaxStyle)

Constructs a plain text document. A default root element is created, and the tab size set to 5.

参数:

syntaxStyle - The syntax highlighting scheme to use.

RSyntaxDocument

public RSyntaxDocument(TokenMakerFactory tmf,
               java.lang.String syntaxStyle)

Constructs a plain text document. A default root element is created, and the tab size set to 5.

参数:

tmf - The TokenMakerFactory for this document. If this is null, a default factory is used.

syntaxStyle - The syntax highlighting scheme to use.

方法详细资料

fireInsertUpdate

protected void fireInsertUpdate(javax.swing.event.DocumentEvent e)

Alerts all listeners to this document of an insertion. This is overridden so we can update our syntax highlighting stuff.

The syntax highlighting stuff has to be here instead of in insertUpdate because insertUpdate is not called by the undo/redo actions, but this method is.

覆盖:

fireInsertUpdate 在类中 javax.swing.text.AbstractDocument

参数:

e - The change.

fireRemoveUpdate

protected void fireRemoveUpdate(javax.swing.event.DocumentEvent chng)

This method is called AFTER the content has been inserted into the document and the element structure has been updated.

The syntax-highlighting updates need to be done here (as opposed to an override of postRemoveUpdate) as this method is called in response to undo/redo events, whereas postRemoveUpdate is not.

Now that the text is actually inserted into the content and element structure, we can update our token elements and "last tokens on lines" structure.

覆盖:

fireRemoveUpdate 在类中 javax.swing.text.AbstractDocument

参数:

chng - The change that occurred.

另请参阅:

PlainDocument.removeUpdate(javax.swing.text.AbstractDocument.DefaultDocumentEvent)

getClosestStandardTokenTypeForInternalType

public int getClosestStandardTokenTypeForInternalType(int type)

Returns the closest "standard" token type for a given "internal" token type (e.g. one whose value is < 0).

参数:

type - The token type.

返回:

The closest "standard" token type. If a mapping is not defined for this language, then type is returned.

getCompleteMarkupCloseTags

public boolean getCompleteMarkupCloseTags()

Returns whether closing markup tags should be automatically completed. This method only returns true if getLanguageIsMarkup() also returns true.

返回:

Whether markup closing tags should be automatically completed.

另请参阅:

getLanguageIsMarkup()

getCurlyBracesDenoteCodeBlocks

public boolean getCurlyBracesDenoteCodeBlocks()

Returns whether the current programming language uses curly braces ('{' and '}') to denote code blocks.

返回:

Whether curly braces denote code blocks.

getLanguageIsMarkup

public boolean getLanguageIsMarkup()

Returns whether the current language is a markup language, such as HTML, XML or PHP.

返回:

Whether the current language is a markup language.

getLastTokenTypeOnLine

public int getLastTokenTypeOnLine(int line)

Returns the token type of the last token on the given line.

参数:

line - The line to inspect.

返回:

The token type of the last token on the specified line. If the line is invalid, an exception is thrown.

getLineCommentStartAndEnd

public java.lang.String[] getLineCommentStartAndEnd()

Returns the text to place at the beginning and end of a line to "comment" it in the current programming language.

返回:

The start and end strings to add to a line to "comment" it out. A null value for either means there is no string to add for that part. A value of null for the array means this language does not support commenting/uncommenting lines.

getShouldIndentNextLine

public boolean getShouldIndentNextLine(int line)

This method returns whether auto indentation should be done if Enter is pressed at the end of the specified line.

参数:

line - The line to check.

返回:

Whether an extra indentation should be done.

getTokenListForLine

public final Token getTokenListForLine(int line)

Returns a token list for the specified segment of text representing the specified line number. This method is basically a wrapper for tokenMaker.getTokenList that takes into account the last token on the previous line to assure token accuracy.

参数:

line - The line number of text in the document, >= 0.

返回:

A token list representing the specified line.

iterator

public java.util.Iterator<Token> iterator()

Returns an iterator over the tokens in this document. Results are undefined if this document is modified while the iterator is being iterated through, so this should only be used on the EDT.

The remove() method of the returned iterator will throw an UnsupportedOperationException.

指定者:

iterator 在接口中 java.lang.Iterable<Token>

返回:

An iterator.

setSyntaxStyle

public void setSyntaxStyle(java.lang.String styleKey)

Sets the syntax style being used for syntax highlighting in this document. What styles are supported by a document is determined by its TokenMakerFactory. By default, all RSyntaxDocuments support all languages built into RSyntaxTextArea.

参数:

styleKey - The new style to use, such as SyntaxConstants.SYNTAX_STYLE_JAVA. If this style is not known or supported by this document, then SyntaxConstants.SYNTAX_STYLE_NONE is used.

另请参阅:

setSyntaxStyle(TokenMaker)

setSyntaxStyle

public void setSyntaxStyle(TokenMaker tokenMaker)

Sets the syntax style being used for syntax highlighting in this document. You should call this method if you've created a custom token maker for a language not normally supported by RSyntaxTextArea.

参数:

tokenMaker - The new token maker to use.

另请参阅:

setSyntaxStyle(String)

setTokenMakerFactory

public void setTokenMakerFactory(TokenMakerFactory tmf)

Sets the token maker factory used by this document.

参数:

tmf - The TokenMakerFactory for this document. If this is null, a default factory is used.

updateSyntaxHighlightingInformation

protected void updateSyntaxHighlightingInformation()

Updates internal state information; e.g. the "last tokens on lines" data. After this, a changed update is fired to let listeners know that the document's structure has changed.

This is called internally whenever the syntax style changes.