NSMutableAttributedString的详细使用(一)

#向参考的博客原文作者致敬
#参考链接:
http://www.jianshu.com/p/8f49c9c99b21
http://www.cnblogs.com/wangbinios/p/6123946.html
http://blog.csdn.net/liujinlongxa/article/details/44840753
#待学习链接
http://www.itnose.net/detail/6177538.html
http://blog.csdn.net/ys410900345/article/details/25976179
http://www.cocoachina.com/ios/20160512/16223.html

本篇博客主要是NSMutableAttributedString的简介篇,详细篇后续有时间跟新,欢迎大家批评改正。

一、创建方式

简述:

NSMutableAttributedString适用的控件非常多,例如:UITextViewUILabelUIButton....等,这里总结就以《UILabel》为例子。
《1》、方式一:
/* 创建一个label */
 UILabel *testLabel = [[UILabel  alloc] initWithFrame:CGRectMake(30, 60, 200, 200)];
/* 自动换行 */
 testLabel.numberOfLines = 0;
/* 初始化的字符串 */
 NSString  *testStr = @"年轻人就要多去挑战,要让不可能成为可能";
#/* 初始化的方式创建 */
 NSMutableAttributedString *attributedString = [[NSMutableAttributedString  alloc] initWithString:testStr];
#//也可以使用此方法初始化创建- (instancetype)initWithString:(NSString *)str;
/****** 最基本的添加属性的方式,使用哪一个属性就添加哪一个 ,这里只是随便使用了几个属性后续有时间还会一一介绍。******/
/*****
    *@Attribute  参数含义:添加的属性名称
    *@value:属性所需要赋的值
    *@range:  添加的属性适应的范围
    ************/
 [attributedString  addAttribute:NSFontAttributeName value:[UIFont fontWithName: @"Zapfino" size: 15] range:NSMakeRange(0, testStr.length)];
 [attributedString addAttribute: NSForegroundColorAttributeName value: [UIColor blueColor] range: NSMakeRange(0, 4)];
 [attributedString addAttribute: NSForegroundColorAttributeName value: [UIColor redColor] range: NSMakeRange(4, 3)];
#/* 这里需要注意UILabel之前是使用Label的`text`属性进行赋值的,但是使用NSMutableAttributedString设置完文本后就要改成控件的`attributedText`属性进行赋值否则会有警告并且赋值不成功。*/
 testLabel.attributedText = attributedString;
 [self.view addSubview:testLabel]
《2》、方式二:
/* 创建一个label */
 UILabel *testLabel = [[UILabel  alloc] initWithFrame:CGRectMake(30, 60, 200, 200)];
/* 自动换行 */
 testLabel.numberOfLines = 0;
/* 初始化的字符串 */
 NSString  *testStr = @"年轻人就要多去挑战,要让不可能成为可能";
#/*使用字典创建,然后直接将要设置的属性添加到字典中  */
NSDictionary *attrDict = @{ NSFontAttributeName: [UIFont fontWithName: @"Zapfino" size: 15], NSForegroundColorAttributeName: [UIColor blueColor] };
#/* 这里使用NSMutableAttributedString中自带的一个个实例方法将刚才设置的全部属性添加进去*/
testLabel.attributedText = [[NSAttributedString alloc] initWithString: testStr attributes: attrDict];
 [self.view  addSubview:testLabel];

二、方法简介

《1》、常用方法简介
/* 初始化方法 */
- (instancetype)initWithString:(NSString *)str;
- (instancetype)initWithString:(NSString *)str attributes:(nullable NSDictionary *)attrs;
- (instancetype)initWithAttributedString:(NSAttributedString *)attrStr;
/* 为某一范围内文字设置多个属性 */
- (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range;
/* 为某一范围内文字添加某个属性 */
- (void)addAttribute:(NSString *)name value:(id)value range:(NSRange)range;
/* 为某一范围内文字添加多个属性 */
- (void)addAttributes:(NSDictionary *)attrs range:(NSRange)range;
/*移除某范围内的某个属性*/
- (void)removeAttribute:(NSString *)name range:(NSRange)range;
《2》、详细介绍一些方法
[1]、获取指定位置上的属性信息,并返回与指定位置属性相同并且连续的字符串的范围信息。
- (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(nullable NSRangePointer)range;
#例如:
  NSRange range = NSMakeRange(0, 2);
  NSDictionary*dic = [attributedString attributesAtIndex:2 effectiveRange:&range];
#参数介绍:    
@location :为位置信息  对应例子中attributesAtIndex:2   
@effectiveRange  有效范围  对应例子中&range
[2]、获取指定范围内的子字符串的信息
#参数介绍:
@NSAttributedString   返回一个NSAttributedString是咧对象
@range  从哪一个范围获取
- (NSAttributedString *)attributedSubstringFromRange:(NSRange)range;
[3]、** 在Range中查找string从attributesAtIndex:开始找,找到的第一个属性,即attributeDict,把属性的位置传给longestEffectiveRange:属性 **
#参数介绍:
@inRange   在字符串中的范围查找
@attributesAtIndex  从哪一个索引开始查找,找到第一个属性
@longestEffectiveRange    将第一个属性的位置传过来
#/* 方法 */
- (NSDictionary *)attributesAtIndex:(NSUInteger)location longestEffectiveRange:(nullable NSRangePointer)range inRange:(NSRange)rangeLimit;
能成为可能";
#范例:
/* 创建一个label */ UILabel *testLabel = [[UILabel alloc] initWithFrame:CGRectMake(30, 60, 200, 200)];
 [self.view  addSubview:testLabel];
 NSString  *testStr = @"年轻人就要多去挑战,要让不可能成为可能";
 NSDictionary *attrDict = @{ NSFontAttributeName: [UIFont fontWithName: @"Zapfino" size: 15], NSForegroundColorAttributeName: [UIColor blueColor] };
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:testStr attributes:attrDict];

 [attributedString  addAttribute:NSForegroundColorAttributeNamevalue: [UIColor redColor]    range:NSMakeRange(7, 5)];
NSDictionary *attributeDict;
NSRange effectiveRange = { 0, 10 };
do {        
 NSRange  range = NSMakeRange (NSMaxRange(effectiveRange), [attributedString length] - NSMaxRange(effectiveRange));
 attributeDict = [attributedString attributesAtIndex: range.location   longestEffectiveRange: &effectiveRange  inRange: range];
 NSLog (@"Range: %@  Attributes: %@",
NSStringFromRange(effectiveRange), attributeDict);
 testLabel.attributedText = attributedString;
} while (NSMaxRange(effectiveRange) < [attributedString length]);
      [4]、判断两个NSAttributedString是否相等
- (BOOL)isEqualToAttributedString:(NSAttributedString *)other;

三、属性简介

1、NSFontAttributeName(字体)

** 该属性所对应的值是一个 UIFont 对象。该属性用于改变一段文本的字体。如果不指定该属性,则默认为12-point Helvetica(Neue)。**

2、NSParagraphStyleAttributeName(段落)

** 该属性所对应的值是一个 NSParagraphStyle 对象。该属性在一段文本上应用多个属性。如果不指定该属性,则默认为 NSParagraphStyle 的defaultParagraphStyle 方法返回的默认段落属性。**

3、NSForegroundColorAttributeName(字体颜色)

** 该属性所对应的值是一个 UIColor 对象。该属性用于指定一段文本的字体颜色。如果不指定该属性,则默认为黑色。**

4、NSBackgroundColorAttributeName(字体背景色)

** 该属性所对应的值是一个 UIColor 对象。该属性用于指定一段文本的背景颜色。如果不指定该属性,则默认无背景色。**

5、NSLigatureAttributeName(连字符)

   该属性所对应的值是一个 NSNumber 对象(整数)。连体字符是指某些连在一起的字符,它们采用单个的图元符号。
- 0 表示没有连体字符。
- 1 表示使用默认的连体字符。
- 2表示使用所有连体符号。
- 默认值为 1(注意,iOS 不支持值为 2)

6、NSKernAttributeName(字间距)

** NSKernAttributeName 设定字符间距,取值为 NSNumber 对象(整数),正值间距加宽,负值间距变窄**

7、NSStrikethroughStyleAttributeName(删除线)

NSStrikethroughStyleAttributeName 设置删除线,取值为 NSNumber 对象(整数),枚举常量 NSUnderlineStyle中的值:
NSUnderlineStyleNone。/*  默认值 */
NSUnderlineStyleNone /* 不设置删除线 */
NSUnderlineStyleSingle/*  设置删除线为细单实线 */
NSUnderlineStyleThick/*  设置删除线为粗单实线 */
NSUnderlineStyleDouble /* 设置删除线为细双实线 */

8、NSStrikethroughColorAttributeName (删除线颜色)

** NSStrikethroughColorAttributeName 设置删除线颜色,取值为 UIColor 对象,默认值为黑色**

9、NSUnderlineStyleAttributeName(下划线)

该属性所对应的值是一个 NSNumber 对象(整数)。
该值指定是否在文字上加上下划线,该值参考“Underline Style Attributes”。
默认值是NSUnderlineStyleNone。
#下划线除了线条位置和删除线不同外,其他的都可以完全参照删除线设置。

10、NSUnderlineColorAttributeName(下划线颜色)

** NSUnderlineColorAttributeName 设置下划线颜色,取值为 UIColor 对象,默认值为黑色 **

11、NSStrokeColorAttributeName(边线颜色)

12、NSStrokeWidthAttributeName(边线宽度)

13、NSShadowAttributeName(阴影)

该属性所对应的值是一个 NSShadow 对象。默认为 nil。单独设置不好使,和这三个任一个都好使,NSVerticalGlyphFormAttributeName,
NSObliquenessAttributeName,
NSExpansionAttributeName

14、NSVerticalGlyphFormAttributeName(横竖排版)

** 该属性所对应的值是一个 NSNumber 对象(整数)。0 表示横排文本。1 表示竖排文本。在 iOS 中,总是使用横排文本,0 以外的值都未定义。**

15、NSObliquenessAttributeName(字体倾斜)

16、NSExpansionAttributeName (文本扁平化)

你可能感兴趣的:(NSMutableAttributedString的详细使用(一))