Instance Method

addAttribute:value:range:

Adds an attribute with the given name and value to the characters in the specified range.

Declaration

- (void)addAttribute:(NSAttributedStringKey)name value:(id)value range:(NSRange)range;

Parameters

name

A string specifying the attribute name. Attribute keys can be supplied by another framework or can be custom ones you define. For information about the system-supplied attribute keys, see the Constants section in NSAttributedString.

value

The attribute value associated with name.

aRange

The range of characters to which the specified attribute/value pair applies.

Discussion

You may assign any name/value pair you wish to a range of characters. Raises an NSInvalidArgumentException if name or value is nil and an NSRangeException if any part of aRange lies beyond the end of the receiver’s characters.

See Also

Changing attributes

- setAttributes:range:

Sets the attributes for the characters in the specified range to the specified attributes.

- addAttributes:range:

Adds the given collection of attributes to the characters in the specified range.

- removeAttribute:range:

Removes the named attribute from the characters in the specified range.

- applyFontTraits:range:

Applies the font attributes specified by mask to the characters in aRange.

- setAlignment:range:

Sets the alignment characteristic of the paragraph style attribute for the characters in aRange to alignment.

- setBaseWritingDirection:range:

Sets the base writing direction for the characters in range to writingDirection.

- subscriptRange:

Decrements the value of the superscript attribute for characters in aRange by 1.

- superscriptRange:

Increments the value of the superscript attribute for characters in aRange by 1.

- unscriptRange:

Removes the superscript attribute from the characters in aRange.