javax.swing.text

Interface MutableAttributeSet

public interface MutableAttributeSet extends AttributeSet

An {@link AttributeSet} that supports modification of the stored attributes.

Since: 1.2

Method Summary
void	addAttribute(Object name, Object value) Adds an attribute with the given `name` and `value` to the set.
void	addAttributes(AttributeSet attributes) Adds all the attributes from `attributes` to this set.
void	removeAttribute(Object name) Removes the attribute with the specified `name`, if this attribute is defined.
void	removeAttributes(Enumeration<?> names) Removes the attributes listed in `names`.
void	removeAttributes(AttributeSet attributes) Removes attributes from this set if they are found in the given set.
void	setResolveParent(AttributeSet parent) Sets the reolving parent for this set.

Method Detail

addAttribute

public void addAttribute(Object name, Object value)

Adds an attribute with the given name and value to the set. If the set already contains an attribute with the given name, the attribute value is updated.

Parameters: name the attribute name (null not permitted). value the value (null not permitted).

Throws: NullPointerException if either argument is null.

addAttributes

public void addAttributes(AttributeSet attributes)

Adds all the attributes from attributes to this set.

Parameters: attributes the set of attributes to add (null not permitted).

Throws: NullPointerException if attributes is null.

removeAttribute

public void removeAttribute(Object name)

Removes the attribute with the specified name, if this attribute is defined. This method will only remove an attribute from this set, not from the resolving parent.

Parameters: name the attribute name (null not permitted).

Throws: NullPointerException if name is null.

removeAttributes

public void removeAttributes(Enumeration<?> names)

Removes the attributes listed in names.

Parameters: names the attribute names (null not permitted).

Throws: NullPointerException if names is null or contains any null values.

removeAttributes

public void removeAttributes(AttributeSet attributes)

Removes attributes from this set if they are found in the given set. Only attributes whose key AND value are removed. Removes attributes only from this set, not from the resolving parent. Since the resolving parent is stored as an attribute, if attributes has the same resolving parent as this set, the parent will be removed from this set.

Parameters: attributes the attributes (null not permitted).

setResolveParent

public void setResolveParent(AttributeSet parent)

Sets the reolving parent for this set. When looking up an attribute, if it is not found in this set, then the resolving parent is also used for the lookup.

Parameters: parent the parent attribute set (null not permitted).

Throws: NullPointerException if parent is null.