Instance Method

setAttributes:range:

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

Declaration

- (void)setAttributes:(NSDictionary<NSAttributedStringKey, id> *)attrs range:(NSRange)range;

Parameters

attributes

A dictionary containing the attributes to set. 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.

aRange

The range of characters whose attributes are set.

Discussion

These new attributes replace any attributes previously associated with the characters in aRange. Raises an NSRangeException if any part of aRange lies beyond the end of the receiver’s characters.

To set attributes for a zero-length NSMutableAttributedString displayed in a text view, use the NSTextView method typingAttributes.

See Also

Changing attributes

- addAttribute:value:range:

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

- 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.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software