RSyntaxUtilities

java.lang.Object
- com.fr.design.gui.syntax.ui.rsyntaxtextarea.RSyntaxUtilities

所有已实现的接口:

javax.swing.SwingConstants
```
public class RSyntaxUtilities
extends java.lang.Object
implements javax.swing.SwingConstants
```
Utility methods used by RSyntaxTextArea and its associated classes.

版本:

0.2

作者:

Robert Futrell

字段概要

字段
限定符和类型	字段和说明
`static int`	`OS_LINUX` Integer constant representing Linux.
`static int`	`OS_MAC_OSX` Integer constant representing Mac OS X.
`static int`	`OS_OTHER` Integer constant representing an "unknown" OS. 99.99% of the time, this means some UNIX variant (AIX, SunOS, etc.).
`static int`	`OS_WINDOWS` Integer constant representing a Windows-variant OS.

从接口继承的字段 javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

构造器概要

构造器
构造器和说明

RSyntaxUtilities()

构造器
构造器和说明
`RSyntaxUtilities()`

方法概要

方法
限定符和类型	方法和说明
`static java.lang.String`	`escapeForHtml(java.lang.String s, java.lang.String newlineReplacement, boolean inPreBlock)` Returns a string with characters that are special to HTML (such as `<`, `>` and `&`) replaced by their HTML escape sequences.
`static java.util.Map<?,?>`	`getDesktopAntiAliasHints()` Returns the rendering hints for text that will most accurately reflect those of the native windowing system.
`static java.awt.Color`	`getFoldedLineBottomColor(RSyntaxTextArea textArea)` Returns the color to use for the line underneath a folded region line.
`static Gutter`	`getGutter(RTextArea textArea)` Returns the gutter component of the scroll pane containing a text area, if any.
`static java.awt.Color`	`getHyperlinkForeground()` Returns the color to use for hyperlink-style components.
`static java.lang.String`	`getLeadingWhitespace(javax.swing.text.Document doc, int offs)` Returns the leading whitespace of a specific line in a document.
`static java.lang.String`	`getLeadingWhitespace(java.lang.String text)` Returns the leading whitespace of a string.
`static java.awt.Rectangle`	`getLineWidthUpTo(RSyntaxTextArea textArea, javax.swing.text.Segment s, int p0, int p1, javax.swing.text.TabExpander e, java.awt.Rectangle rect, int x0)` Returns the bounding box (in the current view) of a specified position in the model.
`static java.awt.Point`	`getMatchingBracketPosition(RSyntaxTextArea textArea, java.awt.Point input)` Returns the location of the bracket paired with the one at the current caret position.
`static Token`	`getNextImportantToken(Token t, RSyntaxTextArea textArea, int line)` Returns the next non-whitespace, non-comment token in a text area.
`static int`	`getNextVisualPositionFrom(int pos, javax.swing.text.Position.Bias b, java.awt.Shape a, int direction, javax.swing.text.Position.Bias[] biasRet, javax.swing.text.View view)` Provides a way to determine the next visually represented model location at which one might place a caret.
`static int`	`getOS()` Returns an integer constant representing the OS.
`static int`	`getPositionAbove(RSyntaxTextArea c, int offs, float x, javax.swing.text.TabExpander e)` Determines the position in the model that is closest to the given view location in the row above.
`static int`	`getPositionBelow(RSyntaxTextArea c, int offs, float x, javax.swing.text.TabExpander e)` Determines the position in the model that is closest to the given view location in the row below.
`static Token`	`getPreviousImportantToken(RSyntaxTextArea textArea, int line)` Returns the last non-whitespace, non-comment token, starting with the specified line.
`static Token`	`getTokenAtOffset(Token tokenList, int offset)` Returns the token at the specified index, or `null` if the given offset isn't in this token list's range.
`static float`	`getTokenListWidth(Token tokenList, RSyntaxTextArea textArea, javax.swing.text.TabExpander e)` Determines the width of the given token list taking tabs into consideration.
`static float`	`getTokenListWidth(Token tokenList, RSyntaxTextArea textArea, javax.swing.text.TabExpander e, float x0)` Determines the width of the given token list taking tabs into consideration.
`static float`	`getTokenListWidthUpTo(Token tokenList, RSyntaxTextArea textArea, javax.swing.text.TabExpander e, float x0, int upTo)` Determines the width of the given token list taking tabs into consideration and only up to the given index in the document (exclusive).
`static int`	`getWordEnd(RSyntaxTextArea textArea, int offs)` Returns the end of the word at the given offset.
`static int`	`getWordStart(RSyntaxTextArea textArea, int offs)` Returns the start of the word at the given offset.
`static boolean`	`isBracket(char ch)` Returns whether or not this character is a "bracket" to be matched by such programming languages as C, C++, and Java.
`static boolean`	`isDigit(char ch)` Returns whether or not a character is a digit (0-9).
`static boolean`	`isHexCharacter(char ch)` Returns whether or not this character is a hex character.
`static boolean`	`isJavaOperator(char ch)` Returns whether a character is a Java operator.
`static boolean`	`isLetter(char ch)` Returns whether a character is a US-ASCII letter (A-Z or a-z).
`static boolean`	`isLetterOrDigit(char ch)` Returns whether or not a character is a US-ASCII letter or a digit.
`static boolean`	`isLightForeground(java.awt.Color fg)` Returns whether the specified color is "light" to use as a foreground.
`static boolean`	`isWhitespace(char ch)` Returns whether or not a character is a whitespace character (either a space ' ' or tab '\t').
`static boolean`	`regexCanFollowInJavaScript(Token t)` Returns whether a regular expression token can follow the specified token in JavaScript.
`static char`	`toLowerCase(char ch)` If the character is an upper-case US-ASCII letter, it returns the lower-case version of that letter; otherwise, it just returns the character.
`static java.util.regex.Pattern`	`wildcardToPattern(java.lang.String wildcard, boolean matchCase, boolean escapeStartChar)` Creates a regular expression pattern that matches a "wildcard" pattern.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - OS_WINDOWS
```
public static final int OS_WINDOWS
```
    Integer constant representing a Windows-variant OS.
    
    另请参阅:
    常量字段值
  - OS_MAC_OSX
```
public static final int OS_MAC_OSX
```
    Integer constant representing Mac OS X.
    
    另请参阅:
    常量字段值
  - OS_LINUX
```
public static final int OS_LINUX
```
    Integer constant representing Linux.
    
    另请参阅:
    常量字段值
  - OS_OTHER
```
public static final int OS_OTHER
```
    Integer constant representing an "unknown" OS. 99.99% of the time, this means some UNIX variant (AIX, SunOS, etc.).
    
    另请参阅:
    常量字段值
- 构造器详细资料
  - RSyntaxUtilities
```
public RSyntaxUtilities()
```
- 方法详细资料
  - escapeForHtml
```
public static final java.lang.String escapeForHtml(java.lang.String s,
                             java.lang.String newlineReplacement,
                             boolean inPreBlock)
```
    Returns a string with characters that are special to HTML (such as <, > and &) replaced by their HTML escape sequences.
    
    参数:
    s - The input string.
    newlineReplacement - What to replace newline characters with. If this is null, they are simply removed.
    inPreBlock - Whether this HTML will be in within pre tags. If this is true, spaces will be kept as-is; otherwise, they will be converted to " ".
    
    返回:
    The escaped version of s.
  - getDesktopAntiAliasHints
```
public static java.util.Map<?,?> getDesktopAntiAliasHints()
```
    Returns the rendering hints for text that will most accurately reflect those of the native windowing system.
    
    返回:
    The rendering hints, or null if they cannot be determined.
  - getFoldedLineBottomColor
```
public static java.awt.Color getFoldedLineBottomColor(RSyntaxTextArea textArea)
```
    Returns the color to use for the line underneath a folded region line.
    
    参数:
    textArea - The text area.
    
    返回:
    The color to use.
  - getGutter
```
public static Gutter getGutter(RTextArea textArea)
```
    Returns the gutter component of the scroll pane containing a text area, if any.
    
    参数:
    textArea - The text area.
    
    返回:
    The gutter, or null if the text area is not in an RTextScrollPane.
    另请参阅:
    RTextScrollPane.getGutter()
  - getHyperlinkForeground
```
public static final java.awt.Color getHyperlinkForeground()
```
    Returns the color to use for hyperlink-style components. This method will return Color.blue unless it appears that the current LookAndFeel uses light text on a dark background, in which case a brighter alternative is returned.
    
    返回:
    The color to use for hyperlinks.
    另请参阅:
    isLightForeground(Color)
  - getLeadingWhitespace
```
public static java.lang.String getLeadingWhitespace(java.lang.String text)
```
    Returns the leading whitespace of a string.
    
    参数:
    text - The String to check.
    
    返回:
    The leading whitespace.
    另请参阅:
    getLeadingWhitespace(Document, int)
  - getLeadingWhitespace
```
public static java.lang.String getLeadingWhitespace(javax.swing.text.Document doc,
                                    int offs)
                                             throws javax.swing.text.BadLocationException
```
    Returns the leading whitespace of a specific line in a document.
    
    参数:
    doc - The document.
    offs - The offset whose line to get the leading whitespace for.
    
    返回:
    The leading whitespace.
    
    抛出:
    
    javax.swing.text.BadLocationException - If offs is not a valid offset in the document.
    另请参阅:
    getLeadingWhitespace(String)
  - getLineWidthUpTo
```
public static java.awt.Rectangle getLineWidthUpTo(RSyntaxTextArea textArea,
                                  javax.swing.text.Segment s,
                                  int p0,
                                  int p1,
                                  javax.swing.text.TabExpander e,
                                  java.awt.Rectangle rect,
                                  int x0)
                                           throws javax.swing.text.BadLocationException
```
    Returns the bounding box (in the current view) of a specified position in the model. This method is designed for line-wrapped views to use, as it allows you to specify a "starting position" in the line, from which the x-value is assumed to be zero. The idea is that you specify the first character in a physical line as p0, as this is the character where the x-pixel value is 0.
    
    参数:
    textArea - The text area containing the text.
    s - A segment in which to load the line. This is passed in so we don't have to reallocate a new Segment for each call.
    p0 - The starting position in the physical line in the document.
    p1 - The position for which to get the bounding box in the view.
    e - How to expand tabs.
    rect - The rectangle whose x- and width-values are changed to represent the bounding box of p1. This is reused to keep from needlessly reallocating Rectangles.
    x0 - The x-coordinate (pixel) marking the left-hand border of the text. This is useful if the text area has a border, for example.
    
    返回:
    The bounding box in the view of the character p1.
    
    抛出:
    
    javax.swing.text.BadLocationException - If p0 or p1 is not a valid location in the specified text area's document.
    
    java.lang.IllegalArgumentException - If p0 and p1 are not on the same line.
  - getMatchingBracketPosition
```
public static java.awt.Point getMatchingBracketPosition(RSyntaxTextArea textArea,
                                        java.awt.Point input)
```
    Returns the location of the bracket paired with the one at the current caret position.
    
    参数:
    textArea - The text area.
    input - A point to use as the return value. If this is null, a new object is created and returned.
    
    返回:
    A point representing the matched bracket info. The "x" field is the offset of the bracket at the caret position (either just before or just after the caret), and the "y" field is the offset of the matched bracket. Both "x" and "y" will be -1 if there isn't a matching bracket (or the caret isn't on a bracket).
  - getNextImportantToken
```
public static final Token getNextImportantToken(Token t,
                          RSyntaxTextArea textArea,
                          int line)
```
    Returns the next non-whitespace, non-comment token in a text area.
    
    参数:
    t - The next token in this line's token list.
    textArea - The text area.
    line - The current line index (the line index of t).
    
    返回:
    The next non-whitespace, non-comment token, or null if there isn't one.
    另请参阅:
    getPreviousImportantToken(RSyntaxTextArea, int)
  - getNextVisualPositionFrom
```
public static int getNextVisualPositionFrom(int pos,
                            javax.swing.text.Position.Bias b,
                            java.awt.Shape a,
                            int direction,
                            javax.swing.text.Position.Bias[] biasRet,
                            javax.swing.text.View view)
                                     throws javax.swing.text.BadLocationException
```
    Provides a way to determine the next visually represented model location at which one might place a caret. Some views may not be visible, they might not be in the same order found in the model, or they just might not allow access to some of the locations in the model.
    NOTE: You should only call this method if the passed-in javax.swing.text.View is an instance of TokenOrientedView and javax.swing.text.TabExpander; otherwise, a ClassCastException could be thrown.
    参数:
    pos - the position to convert >= 0
    a - the allocated region in which to render
    direction - the direction from the current position that can be thought of as the arrow keys typically found on a keyboard. This will be one of the following values:
    
    SwingConstants.WEST
    SwingConstants.EAST
    SwingConstants.NORTH
    SwingConstants.SOUTH
    返回:
    the location within the model that best represents the next location visual position
    
    抛出:
    
    javax.swing.text.BadLocationException
    
    java.lang.IllegalArgumentException - if direction doesn't have one of the legal values above
  - getPositionAbove
```
public static final int getPositionAbove(RSyntaxTextArea c,
                   int offs,
                   float x,
                   javax.swing.text.TabExpander e)
                                  throws javax.swing.text.BadLocationException
```
    Determines the position in the model that is closest to the given view location in the row above. The component given must have a size to compute the result. If the component doesn't have a size a value of -1 will be returned.
    
    参数:
    c - the editor
    offs - the offset in the document >= 0
    x - the X coordinate >= 0
    
    返回:
    the position >= 0 if the request can be computed, otherwise a value of -1 will be returned.
    
    抛出:
    
    javax.swing.text.BadLocationException - if the offset is out of range
  - getPositionBelow
```
public static final int getPositionBelow(RSyntaxTextArea c,
                   int offs,
                   float x,
                   javax.swing.text.TabExpander e)
                                  throws javax.swing.text.BadLocationException
```
    Determines the position in the model that is closest to the given view location in the row below. The component given must have a size to compute the result. If the component doesn't have a size a value of -1 will be returned.
    
    参数:
    c - the editor
    offs - the offset in the document >= 0
    x - the X coordinate >= 0
    
    返回:
    the position >= 0 if the request can be computed, otherwise a value of -1 will be returned.
    
    抛出:
    
    javax.swing.text.BadLocationException - if the offset is out of range
  - getPreviousImportantToken
```
public static final Token getPreviousImportantToken(RSyntaxTextArea textArea,
                              int line)
```
    Returns the last non-whitespace, non-comment token, starting with the specified line.
    
    参数:
    textArea - The text area.
    line - The line at which to start looking.
    
    返回:
    The last non-whitespace, non-comment token, or null if there isn't one.
    另请参阅:
    getNextImportantToken(Token, RSyntaxTextArea, int)
  - getTokenAtOffset
```
public static final Token getTokenAtOffset(Token tokenList,
                     int offset)
```
    Returns the token at the specified index, or null if the given offset isn't in this token list's range.
    Note that this method does NOT check to see if tokenList is null; callers should check for themselves.
    
    参数:
    tokenList - The list of tokens in which to search.
    offset - The offset at which to get the token.
    
    返回:
    The token at offset, or null if none of the tokens are at that offset.
  - getWordEnd
```
public static int getWordEnd(RSyntaxTextArea textArea,
             int offs)
                      throws javax.swing.text.BadLocationException
```
    Returns the end of the word at the given offset.
    
    参数:
    textArea - The text area.
    offs - The offset into the text area's content.
    
    返回:
    The end offset of the word.
    
    抛出:
    
    javax.swing.text.BadLocationException - If offs is invalid.
    另请参阅:
    getWordStart(RSyntaxTextArea, int)
  - getWordStart
```
public static int getWordStart(RSyntaxTextArea textArea,
               int offs)
                        throws javax.swing.text.BadLocationException
```
    Returns the start of the word at the given offset.
    
    参数:
    textArea - The text area.
    offs - The offset into the text area's content.
    
    返回:
    The start offset of the word.
    
    抛出:
    
    javax.swing.text.BadLocationException - If offs is invalid.
    另请参阅:
    getWordEnd(RSyntaxTextArea, int)
  - getTokenListWidth
```
public static final float getTokenListWidth(Token tokenList,
                      RSyntaxTextArea textArea,
                      javax.swing.text.TabExpander e)
```
    Determines the width of the given token list taking tabs into consideration. This is implemented in a 1.1 style coordinate system where ints are used and 72dpi is assumed.
    This method also assumes that the passed-in token list begins at x-pixel 0 in the view (for tab purposes).
    
    参数:
    tokenList - The tokenList list representing the text.
    textArea - The text area in which this token list resides.
    e - The tab expander. This value cannot be null.
    
    返回:
    The width of the token list, in pixels.
  - getTokenListWidth
```
public static final float getTokenListWidth(Token tokenList,
                      RSyntaxTextArea textArea,
                      javax.swing.text.TabExpander e,
                      float x0)
```
    Determines the width of the given token list taking tabs into consideration. This is implemented in a 1.1 style coordinate system where ints are used and 72dpi is assumed.
    
    参数:
    tokenList - The token list list representing the text.
    textArea - The text area in which this token list resides.
    e - The tab expander. This value cannot be null.
    x0 - The x-pixel coordinate of the start of the token list.
    
    返回:
    The width of the token list, in pixels.
    另请参阅:
    getTokenListWidthUpTo(com.fr.design.gui.syntax.ui.rsyntaxtextarea.Token, com.fr.design.gui.syntax.ui.rsyntaxtextarea.RSyntaxTextArea, javax.swing.text.TabExpander, float, int)
  - getTokenListWidthUpTo
```
public static final float getTokenListWidthUpTo(Token tokenList,
                          RSyntaxTextArea textArea,
                          javax.swing.text.TabExpander e,
                          float x0,
                          int upTo)
```
    Determines the width of the given token list taking tabs into consideration and only up to the given index in the document (exclusive).
    
    参数:
    tokenList - The token list representing the text.
    textArea - The text area in which this token list resides.
    e - The tab expander. This value cannot be null.
    x0 - The x-pixel coordinate of the start of the token list.
    upTo - The document position at which you want to stop, exclusive. If this position is before the starting position of the token list, a width of 0 will be returned; similarly, if this position comes after the entire token list, the width of the entire token list is returned.
    
    返回:
    The width of the token list, in pixels, up to, but not including, the character at position upTo.
    另请参阅:
    getTokenListWidth(com.fr.design.gui.syntax.ui.rsyntaxtextarea.Token, com.fr.design.gui.syntax.ui.rsyntaxtextarea.RSyntaxTextArea, javax.swing.text.TabExpander)
  - isBracket
```
public static final boolean isBracket(char ch)
```
    Returns whether or not this character is a "bracket" to be matched by such programming languages as C, C++, and Java.
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a "bracket" - one of '(', ')', '[', ']', '{', and '}'.
  - isDigit
```
public static final boolean isDigit(char ch)
```
    Returns whether or not a character is a digit (0-9).
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a digit.
  - isHexCharacter
```
public static final boolean isHexCharacter(char ch)
```
    Returns whether or not this character is a hex character. This method accepts both upper- and lower-case letters a-f.
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a hex character 0-9, a-f, or A-F.
  - isJavaOperator
```
public static final boolean isJavaOperator(char ch)
```
    Returns whether a character is a Java operator. Note that C and C++ operators are the same as Java operators.
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a Java operator.
  - isLetter
```
public static final boolean isLetter(char ch)
```
    Returns whether a character is a US-ASCII letter (A-Z or a-z).
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a US-ASCII letter.
  - isLetterOrDigit
```
public static final boolean isLetterOrDigit(char ch)
```
    Returns whether or not a character is a US-ASCII letter or a digit.
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a US-ASCII letter or a digit.
  - isLightForeground
```
public static final boolean isLightForeground(java.awt.Color fg)
```
    Returns whether the specified color is "light" to use as a foreground. Colors that return true indicate that the current Look and Feel probably uses light text colors on a dark background.
    
    参数:
    fg - The foreground color.
    
    返回:
    Whether it is a "light" foreground color.
    另请参阅:
    getHyperlinkForeground()
  - isWhitespace
```
public static final boolean isWhitespace(char ch)
```
    Returns whether or not a character is a whitespace character (either a space ' ' or tab '\t'). This checks for the Unicode character values 0x0020 and 0x0009.
    
    参数:
    ch - The character to check.
    
    返回:
    Whether or not the character is a whitespace character.
  - regexCanFollowInJavaScript
```
public static boolean regexCanFollowInJavaScript(Token t)
```
    Returns whether a regular expression token can follow the specified token in JavaScript.
    
    参数:
    t - The token to check, which may be null.
    
    返回:
    Whether a regular expression token may follow this one in JavaScript.
  - toLowerCase
```
public static final char toLowerCase(char ch)
```
    If the character is an upper-case US-ASCII letter, it returns the lower-case version of that letter; otherwise, it just returns the character.
    
    参数:
    ch - The character to lower-case (if it is a US-ASCII upper-case character).
    
    返回:
    The lower-case version of the character.
  - getOS
```
public static final int getOS()
```
    Returns an integer constant representing the OS. This can be handy for special case situations such as Mac OS-X (special application registration) or Windows (allow mixed case, etc.).
    
    返回:
    An integer constant representing the OS.
  - wildcardToPattern
```
public static java.util.regex.Pattern wildcardToPattern(java.lang.String wildcard,
                                        boolean matchCase,
                                        boolean escapeStartChar)
```
    Creates a regular expression pattern that matches a "wildcard" pattern.
    
    参数:
    wildcard - The wildcard pattern.
    matchCase - Whether the pattern should be case sensitive.
    escapeStartChar - Whether to escape a starting '^' character.
    
    返回:
    The pattern.

类 RSyntaxUtilities

字段概要

从接口继承的字段 javax.swing.SwingConstants

构造器概要

方法概要

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

字段详细资料

OS_WINDOWS

OS_MAC_OSX

OS_LINUX

OS_OTHER

构造器详细资料

RSyntaxUtilities

方法详细资料

escapeForHtml

getDesktopAntiAliasHints

getFoldedLineBottomColor

getGutter

getHyperlinkForeground

getLeadingWhitespace

getLeadingWhitespace

getLineWidthUpTo

getMatchingBracketPosition

getNextImportantToken

getNextVisualPositionFrom

getPositionAbove

getPositionBelow

getPreviousImportantToken

getTokenAtOffset

getWordEnd

getWordStart

getTokenListWidth

getTokenListWidth

getTokenListWidthUpTo

isBracket

isDigit

isHexCharacter

isJavaOperator

isLetter

isLetterOrDigit

isLightForeground

isWhitespace

regexCanFollowInJavaScript

toLowerCase

getOS

wildcardToPattern