Function

CFAttributedStringGetAttributeAndLongestEffectiveRange

Returns the value of a given attribute of an attributed string at a specified location.

Declaration

CFTypeRef CFAttributedStringGetAttributeAndLongestEffectiveRange(CFAttributedStringRef aStr, CFIndex loc, CFStringRef attrName, CFRange inRange, CFRange *longestEffectiveRange);

Parameters

str

The attributed string to examine.

loc

The location in str at which to determine the attributes. It is a programming error for loc to specify a location outside the bounds of str.

attrName

The name of the attribute whose value you want to determine.

inRange

The range in str within which you want to find the longest effective range of the attributes at loc. inRange must not exceed the bounds of str.

effectiveRange

If not NULL, upon return contains the maximal range within inRange over which the exact same set of attributes apply. The returned range is clipped to inRange.

Return Value

A dictionary that contains the attributes of str at the specified location. Ownership follows the The Get Rule.

See Also

Accessing Attributes

CFAttributedStringGetAttribute

Returns the value of a given attribute of an attributed string at a specified location.

CFAttributedStringGetAttributes

Returns the attributes of an attributed string at a specified location.

CFAttributedStringGetAttributesAndLongestEffectiveRange

Returns the attributes of an attributed string at a specified location.