Eclipse Platform
Release 3.4

org.eclipse.jface.viewers
Class StyledString

java.lang.Object
  extended byorg.eclipse.jface.viewers.StyledString

public class StyledString
extends Object

A mutable string with styled ranges. All ranges mark substrings of the string and do not overlap. Styles are applied using instances of StyledString.Styler to compute the result of getStyleRanges(). The styled string can be built in the following two ways:

This class may be instantiated; it is not intended to be subclassed.

Since:
3.4

Nested Class Summary
static class StyledString.Styler
          A styler will be asked to apply its styles to one ore more ranges in the StyledString.
 
Field Summary
static StyledString.Styler COUNTER_STYLER
          A built-in styler using the JFacePreferences.COUNTER_COLOR managed in the JFace color registry (See JFaceResources.getColorRegistry()).
static StyledString.Styler DECORATIONS_STYLER
          A built-in styler using the JFacePreferences.DECORATIONS_COLOR managed in the JFace color registry (See JFaceResources.getColorRegistry()).
static StyledString.Styler QUALIFIER_STYLER
          A built-in styler using the JFacePreferences.QUALIFIER_COLOR managed in the JFace color registry (See JFaceResources.getColorRegistry()).
 
Constructor Summary
StyledString()
          Creates an empty StyledString.
StyledString(String string)
          Creates an StyledString initialized with a string without a style associated.
StyledString(String string, StyledString.Styler styler)
          Creates an StyledString initialized with a string and a style.
 
Method Summary
 StyledString append(char ch)
          Appends the string representation of the given character to the StyledString.
 StyledString append(char[] chars)
          Appends the string representation of the given character array to the StyledString.
 StyledString append(char[] chars, StyledString.Styler styler)
          Appends the string representation of the given character array with a style to the StyledString.
 StyledString append(char ch, StyledString.Styler styler)
          Appends the string representation of the given character with a style to the StyledString.
 StyledString append(String string)
          Appends a string to the StyledString.
 StyledString append(String string, StyledString.Styler styler)
          Appends a string with a style to the StyledString.
 StyledString append(StyledString string)
          Appends a string with styles to the StyledString.
static StyledString.Styler createColorRegistryStyler(String foregroundColorName, String backgroundColorName)
          Creates a styler that takes the given foreground and background colors from the JFace color registry.
 String getString()
          Returns the string of this StyledString.
 StyleRange[] getStyleRanges()
          Returns an array of StyleRange resulting from applying all associated stylers for this string builder.
 int length()
          Returns the length of the string of this StyledString.
 void setStyle(int offset, int length, StyledString.Styler styler)
          Sets a styler to use for the given source range.
 String toString()
          Returns the string of this StyledString.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

QUALIFIER_STYLER

public static final StyledString.Styler QUALIFIER_STYLER
A built-in styler using the JFacePreferences.QUALIFIER_COLOR managed in the JFace color registry (See JFaceResources.getColorRegistry()).


COUNTER_STYLER

public static final StyledString.Styler COUNTER_STYLER
A built-in styler using the JFacePreferences.COUNTER_COLOR managed in the JFace color registry (See JFaceResources.getColorRegistry()).


DECORATIONS_STYLER

public static final StyledString.Styler DECORATIONS_STYLER
A built-in styler using the JFacePreferences.DECORATIONS_COLOR managed in the JFace color registry (See JFaceResources.getColorRegistry()).

Constructor Detail

StyledString

public StyledString()
Creates an empty StyledString.


StyledString

public StyledString(String string)
Creates an StyledString initialized with a string without a style associated.

Parameters:
string - the string

StyledString

public StyledString(String string,
                    StyledString.Styler styler)
Creates an StyledString initialized with a string and a style.

Parameters:
string - the string
styler - the styler for the string or null to not associated a styler.
Method Detail

createColorRegistryStyler

public static StyledString.Styler createColorRegistryStyler(String foregroundColorName,
                                                            String backgroundColorName)
Creates a styler that takes the given foreground and background colors from the JFace color registry.

Parameters:
foregroundColorName - the color name for the foreground color
backgroundColorName - the color name for the background color
Returns:
the created style

getString

public String getString()
Returns the string of this StyledString.

Returns:
the current string of this StyledString.

toString

public String toString()
Returns the string of this StyledString.

Returns:
the current string of this StyledString.

length

public int length()
Returns the length of the string of this StyledString.

Returns:
the length of the current string

append

public StyledString append(String string)
Appends a string to the StyledString. The appended string will have no associated styler.

Parameters:
string - the string to append
Returns:
returns a reference to this object

append

public StyledString append(char[] chars)
Appends the string representation of the given character array to the StyledString. The appended character array will have no associated styler.

Parameters:
chars - the character array to append
Returns:
returns a reference to this object

append

public StyledString append(char ch)
Appends the string representation of the given character to the StyledString. The appended character will have no associated styler.

Parameters:
ch - the character to append
Returns:
returns a reference to this object

append

public StyledString append(StyledString string)
Appends a string with styles to the StyledString.

Parameters:
string - the string to append
Returns:
returns a reference to this object

append

public StyledString append(char ch,
                           StyledString.Styler styler)
Appends the string representation of the given character with a style to the StyledString. The appended character will have the given style associated.

Parameters:
ch - the character to append
styler - the styler to use for styling the character to append or null if no styler should be associated with the appended character
Returns:
returns a reference to this object

append

public StyledString append(String string,
                           StyledString.Styler styler)
Appends a string with a style to the StyledString. The appended string will be styled using the given styler.

Parameters:
string - the string to append
styler - the styler to use for styling the string to append or null if no styler should be associated with the appended string.
Returns:
returns a reference to this object

append

public StyledString append(char[] chars,
                           StyledString.Styler styler)
Appends the string representation of the given character array with a style to the StyledString. The appended character array will be styled using the given styler.

Parameters:
chars - the character array to append
styler - the styler to use for styling the character array to append or null if no styler should be associated with the appended character array
Returns:
returns a reference to this object

setStyle

public void setStyle(int offset,
                     int length,
                     StyledString.Styler styler)
Sets a styler to use for the given source range. The range must be subrange of actual string of this StyledString. Stylers previously set for that range will be overwritten.

Parameters:
offset - the start offset of the range
length - the length of the range
styler - the styler to set
Throws:
StringIndexOutOfBoundsException - if start is less than zero, or if offset plus length is greater than the length of this object.

getStyleRanges

public StyleRange[] getStyleRanges()
Returns an array of StyleRange resulting from applying all associated stylers for this string builder.

Returns:
an array of all StyleRange resulting from applying the stored stylers to this string.

Eclipse Platform
Release 3.4

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.