Adds an attribute to the given set, and returns the new representative set.

  Adds an attribute to the given set, and returns the new representative set.

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.
Returns: the updated attribute set
Parameters:
- old - the old attribute set
- name - the non-null attribute name
- value - the attribute value
See Also: MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object),

  Adds a set of attributes to the element.

  Adds a set of attributes to the element.

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.
Returns: the updated attribute set
Parameters:
- old - the old attribute set
- attr - the attributes to add
See Also: MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object),

  Adds a listener to track when styles are added or removed.

  Adds a listener to track when styles are added
or removed.
Parameters:
- l - the change listener

  Adds a new style into the style hierarchy.

  Adds a new style into the style hierarchy. Style attributes
resolve from bottom up so an attribute specified in a child
will override an attribute specified in the parent.
Returns: the created style
Parameters:
- nm - the name of the style (must be unique within the collection of named styles in the document). The name may be null if the style is unnamed, but the caller is responsible for managing the reference returned as an unnamed style can't be fetched by name. An unnamed style may be useful for things like character attribute overrides such as found in a style run.
- parent - the parent style. This may be null if unspecified attributes need not be resolved in some other style.

  Create a large set of attributes that should trade off space for time.

  Create a large set of attributes that should trade off
space for time. This set will not be shared. This is
a hook for subclasses that want to alter the behavior
of the larger attribute storage format (which is
SimpleAttributeSet by default). This can be reimplemented
to return a MutableAttributeSet that provides some sort of
attribute conversion.
Parameters:
- a - The set of attributes to be represented in the the larger form.

  Create a compact set of attributes that might be shared.

  Create a compact set of attributes that might be shared.
This is a hook for subclasses that want to alter the
behavior of SmallAttributeSet. This can be reimplemented
to return an AttributeSet that provides some sort of
attribute conversion.
Parameters:
- a - The set of attributes to be represented in the the compact form.

  Takes a set of attributes and turn it into a background color specification.

  Takes a set of attributes and turn it into a background color
specification. This might be used to specify things
like brighter, more hue, etc. By default it simply returns
the value specified by the StyleConstants.Background attribute.
Returns: the color
Parameters:
- attr - the set of attributes

  Returns an array of all the ChangeListeners added to this StyleContext with addChangeListener().

  Returns an array of all the ChangeListeners added
to this StyleContext with addChangeListener().
Returns: all of the ChangeListeners added or an empty array if no listeners have been added
Since: 1.4

  Returns the maximum number of key/value pairs to try and compress into unique/immutable sets.

  Returns the maximum number of key/value pairs to try and
compress into unique/immutable sets. Any sets above this
limit will use hashtables and be a MutableAttributeSet.
Returns: the threshold

  Returns default AttributeContext shared by all documents that don't bother to define/supply their own context.

  Returns default AttributeContext shared by all documents that
don't bother to define/supply their own context.
Returns: the context

  Fetches an empty AttributeSet.

  Fetches an empty AttributeSet.
Returns: the set

  Gets the font from an attribute set.

  Gets the font from an attribute set. This is
implemented to try and fetch a cached font
for the given AttributeSet, and if that fails
the font features are resolved and the
font is fetched from the low-level font cache.
Returns: the font
Parameters:
- attr - the attribute set

  Gets a new font.

  Gets a new font. This returns a Font from a cache
if a cached font exists. If not, a Font is added to
the cache. This is basically a low-level cache for
1.1 font features.
Returns: the new font
Parameters:
- family - the font family (such as "Monospaced")
- style - the style of the font (such as Font.PLAIN)
- size - the point size >= 1

  Returns font metrics for a font.

  Returns font metrics for a font.
Returns: the metrics
Parameters:
- f - the font

  Takes a set of attributes and turn it into a foreground color specification.

  Takes a set of attributes and turn it into a foreground color
specification. This might be used to specify things
like brighter, more hue, etc. By default it simply returns
the value specified by the StyleConstants.Foreground attribute.
Returns: the color
Parameters:
- attr - the set of attributes

  Search for an existing attribute set using the current search parameters.

  Search for an existing attribute set using the current search
parameters. If a matching set is found, return it. If a match
is not found, we create a new set and add it to the pool.

Creates a mutable attribute set to hand out because the current needs are too big to try and use a shared version.

Returns the object previously registered with registerStaticAttributeKey.

  Returns the String that key will be registered with

  Returns the String that key will be registered with
See Also: StyleContext.getStaticAttribute(java.lang.Object), StyleContext.registerStaticAttributeKey(java.lang.Object),

  Fetches a named style previously added to the document

  Fetches a named style previously added to the document
Returns: the style
Parameters:
- nm - the name of the style

  Fetches the names of the styles defined.

  Fetches the names of the styles defined.
Returns: the list of names as an enumeration

Context-specific handling of reading in attributes

  Reads a set of attributes from the given object input stream that have been previously written out with writeAttributeSet.

  Reads a set of attributes from the given object input
stream that have been previously written out with
writeAttributeSet. This will try to restore
keys that were static objects to the static objects in
the current virtual machine considering only those keys
that have been registered with the
registerStaticAttributeKey method.
The attributes retrieved from the stream will be placed
into the given mutable set.
Parameters:
- in - the object stream to read the attribute data from.
- a - the attribute set to place the attribute definitions in.
Throws:
- ClassNotFoundException - passed upward if encountered when reading the object stream.
- IOException - passed upward if encountered when reading the object stream.

  Returns a set no longer needed by the MutableAttributeSet implmentation.

  Returns a set no longer needed by the MutableAttributeSet implmentation. This is useful for operation under 1.1 where there are no weak references. This would typically be called by the finalize method of the MutableAttributeSet implementation.

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.
Parameters:
- a - the set to reclaim

  Registers an object as a static object that is being used as a key in attribute sets.

  Registers an object as a static object that is being used as a key in attribute sets. This allows the key to be treated specially for serialization.

For operation under a 1.1 virtual machine, this uses the value returned by toString concatenated to the classname. The value returned by toString should not have the class reference in it (ie it should be reimplemented from the definition in Object) in order to be the same when recomputed later.
Parameters:
- key - the non-null object key

  Removes an attribute from the set.

  Removes an attribute from the set.

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.
Returns: the updated attribute set
Parameters:
- old - the old set of attributes
- name - the non-null attribute name
See Also: MutableAttributeSet.removeAttribute(java.lang.Object),

  Removes a set of attributes for the element.

  Removes a set of attributes for the element.

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.
Returns: the updated attribute set
Parameters:
- old - the old attribute set
- attrs - the attributes
See Also: MutableAttributeSet.removeAttributes(java.util.Enumeration),

  Removes a set of attributes for the element.

  Removes a set of attributes for the element.

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.
Returns: the updated attribute set
Parameters:
- old - the old attribute set
- names - the attribute names
See Also: MutableAttributeSet.removeAttributes(java.util.Enumeration),

  Removes a listener that was tracking styles being added or removed.

  Removes a listener that was tracking styles being
added or removed.
Parameters:
- l - the change listener

  Removes a named style previously added to the document.

  Removes a named style previously added to the document.
Parameters:
- nm - the name of the style to remove

Clean the unused immutable sets out of the hashtable.

  Converts a StyleContext to a String.

  Converts a StyleContext to a String.
Returns: the string

Context-specific handling of writing out attributes

  Writes a set of attributes to the given object stream for the purpose of serialization.

  Writes a set of attributes to the given object stream
for the purpose of serialization. This will take
special care to deal with static attribute keys that
have been registered wit the
registerStaticAttributeKey method.
Any attribute key not regsitered as a static key
will be serialized directly. All values are expected
to be serializable.
Parameters:
- out - the output stream
- a - the attribute set
Throws:
- IOException - on any I/O error