Instance Method インスタンスメソッド

attributesAtIndex:longestEffectiveRange:inRange:

Returns the attributes for the character at the specified index and, by reference, the range where the attributes apply. この指定されたインデックスでの文字に対する属性そして、参照によって、その属性が適用されるところの範囲を返します。

Declaration 宣言

- (NSDictionary<NSAttributedStringKey, id> *)attributesAtIndex:(NSUInteger)location 
                                         longestEffectiveRange:(NSRangePointer)range 
                                                       inRange:(NSRange)rangeLimit;

Parameters パラメータ

index

The index for which to return attributes. This value must not exceed the bounds of the receiver. それに対して属性を返すことになるインデックス。この値は、レシーバの境界を越えてはなりません。

aRange

If non-NULL, upon return contains the maximum range over which the attributes and values are the same as those at index, clipped to rangeLimit. NULLならば、戻りにおいて、それに対する属性と値がindexでのそれらと同じである最大限範囲を含みます、rangeLimitへと短縮されます。

rangeLimit

The range over which to search for continuous presence of the attributes at index. This value must not exceed the bounds of the receiver. それに対してindexでの属性の連続した存在を検索することになる範囲。この値は、レシーバの境界を越えてはなりません。

Discussion 議論

Raises an NSRangeException if index or any part of rangeLimit lies beyond the end of the receiver’s characters. NSRangeExceptionを引き起こします、もしindexまたはrangeLimitの何らかの部分がレシーバの持つ文字の終わりを越えているならば。

If you don’t need the range information, it’s far more efficient to use the attributesAtIndex:effectiveRange: method to retrieve the attribute value. あなたが範囲情報を必要としなしならば、attributesAtIndex:effectiveRange:メソッドを使って属性値を回収する方が、はるかに効率的です。

For a list of possible attributes, see NSAttributedStringKey. 可能な属性の一覧として、NSAttributedStringKeyを見てください。

See Also 参照

Retrieving Attribute Information 属性情報を回収する