NSAttributedString
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了NSAttributedString相关的知识,希望对你有一定的参考价值。
概述
UIKit 在 NSAttributedString 中加入了新的方法,以支持格式化文本的绘制、计算文本在绘制前的大小及空间。这些方法不影响文本的内容,只影响绘制的过程。
默认,文本绘制使用本地坐标,内容从某个点向右向下绘制。当你放置文本内容时,记住文本块的左上角就是绘制的起点。
你可以在主线程之外使用这些方法,但是,如果是支持NSStringDrawingContext 的任何方法,则无法跨过线程或 dispatch queue 共享 NSStringDrawiingContext。
一、实例方法
- – drawAtPoint:
- – drawInRect:
- – drawWithRect:options:context:
- – size
- – boundingRectWithSize:options:context:
二、实例方法
boundingRectWithSize:options:context:
返回文本绘制所占据的矩形空间。
- (CGRect)boundingRectWithSize:(CGSize)size options:(NSStringDrawingOptions)options context:(NSStringDrawingContext *)context
参数译:
size
宽高限制,用于计算文本绘制时占据的矩形块。
Thewidth and height constraints to apply when computing the string’s boundingrectangle.
options
文本绘制时的附加选项。可能取值请参考“NSStringDrawingOptions”。
context
context上下文。包括一些信息,例如如何调整字间距以及缩放。最终,该对象包含的信息将用于文本绘制。该参数可为 nil 。
返回值 CGRect
一个矩形,大小等于文本绘制完将占据的宽和高。
讨论
可以使用该方法计算文本绘制所需的空间。size 参数是一个constraint ,用于在绘制文本时作为参考。但是,如果绘制完整个文本需要更大的空间,则返回的矩形大小可能比 size 更大。一般,绘制时会采用constraint 提供的宽度,但高度则会根据需要而定。
特殊情况
为了计算文本块的大小,该方法采用默认基线。
如果 NSStringDrawingUsesLineFragmentOrigin未指定,矩形的高度将被忽略,同时使用单线绘制。(由于一个 bug,在 ios6 中,宽度会被忽略)
兼容性
- iOS 6.0 以后支持。
声明于
NSStringDrawing.h
---------------------------------------------------------------------------------------------------
drawAtPoint:
从指定点(当前图形上下文)开始绘制文本。
- (void)drawAtPoint:(CGPoint)point
参数译:
point
当前图形上下文中的点,文本将从此开始绘制。该图形上下文的坐标系通常由当前正在绘制的视图定义。
讨论
该方法从某个点开始绘制整个文本。该方法根据 attributedstring 的属性来绘制行。如果文本中出现换行符,将进行换行,后续的文本将被放到下一行的最初位置。
兼容性
- iOS 6.0 以后支持.
声明于
NSStringDrawing.h
---------------------------------------------------------------------------------------------------
- (void)drawInRect:(CGRect)rect
参数译:
rect
指定绘制文本的矩形范围。
讨论
该 方法在指定矩形内绘制尽可能多的文本内容,必要时会压缩字符。如果对于该矩形来说,文本内容太长,该方法绘制尽可能多的内容,剩余内容将被剪切。该方法用 attributed string 的属性来绘制行。如果文本中出现换行符,将进行换行,后续的文本将被放到下一行的最初位置。
兼容性
- Available in iOS 6.0 and later.
声明于
NSStringDrawing.h
---------------------------------------------------------------------------------------------------
- (void)drawWithRect:(CGRect)rect options:(NSStringDrawingOptions)options context:(NSStringDrawingContext *)context
参数译:
rect
指定在某个矩形中绘制文本。
options
文本绘制选项。可能取值请参考“NSStringDrawingOptions”。
context
上下文对象,用于包含信息:如何调整字间距以及缩放。最终,该对象包含的信息将用于文本绘制。该参数可为 nil。
讨论
该方法在指定矩形内绘制尽可能多的文本内容,必要时会对字符进行压缩。如果矩形内要绘制的文本内容太长,该方法将根据需要缩放字体,或者调整字符间距。
该方法用 attributed string 的属性来绘制行。如果文本中出现换行符,将进行换行,后续的文本将被放到下一行的最初位置。
特殊情况
该方法采用默认基线。
如果NSStringDrawingUsesLineFragmentOrigin 未指定,矩形的高度将被忽略,同时使用单线绘制。(由于一个 bug,在 iOS6 中,宽度会被忽略)
兼容性
- iOS 6.0 以后支持.
声明于
NSStringDrawing.h
---------------------------------------------------------------------------------------------------
size
返回文本绘制所需 size。
Returns the sizerequired to draw the string.
- (CGSize)size
返回值
绘制完整文本所需的最小 size。
讨论
可以用该方法在绘制之前计算需要多大空间。
兼容性
- iOS 6.0 以后支持.
声明于
NSStringDrawing.h
---------------------------------------------------------------------------------------------------
常量
NSStringDrawingOptions
文本绘制选项。
enum {
NSStringDrawingTruncatesLastVisibleLine= 1 << 5,
NSStringDrawingUsesLineFragmentOrigin= 1 << 0,
NSStringDrawingUsesFontLeading= 1 << 1,
NSStringDrawingUsesDeviceMetrics= 1 << 3,
};
typedef NSInteger NSStringDrawingOptions;
常量
NSStringDrawingTruncatesLastVisibleLine
如果文本内容超出指定的矩形限制,文本将被截去并在最后一个字符后加上省略号。如果指定了NSStringDrawingUsesLineFragmentOrigin选项,则该选项被忽略。
NSStringDrawingUsesLineFragmentOrigin
绘制文本时使用 line fragement origin 而不是 baseline origin。
Theorigin specified when drawing the string is the line fragment origin and notthe baseline origin.
NSStringDrawingUsesFontLeading
计算行高时使用行间距。(译者注:字体大小+行间距=行高)
NSStringDrawingUsesDeviceMetrics
计算布局时使用图元字形(而不是印刷字体)。
Usethe image glyph bounds (instead of the typographic bounds) when computinglayout.
---------------------------------------------------------------------------------------------------
划线样式属性
指定下划线或删除线样式。
enum {
NSUnderlineStyleNone = 0x00,
NSUnderlineStyleSingle= 0x01,
};
常量
NSUnderlineStyleNone
不划线。
NSUnderlineStyleSingle
单线
讨论
可以在属性字串的 NSUnderlineStyleAttributeName和NSStrikethroughStyleAttributeName属性上使用这些常量。
---------------------------------------------------------------------------------------------------
字符属性
字符属性可以应用于 attributed string 的文本中。
NSString *const NSFontAttributeName;
NSString *const NSParagraphStyleAttributeName;
NSString *const NSForegroundColorAttributeName;
NSString *const NSBackgroundColorAttributeName;
NSString *const NSLigatureAttributeName;
NSString *const NSKernAttributeName;
NSString *const NSStrikethroughStyleAttributeName;
NSString *const NSUnderlineStyleAttributeName;
NSString *const NSStrokeColorAttributeName;
NSString *const NSStrokeWidthAttributeName;
NSString *const NSShadowAttributeName;
NSString *const NSVerticalGlyphFormAttributeName;
常量解释:
NSFontAttributeName
该属性所对应的值是一个 UIFont 对象。该属性用于改变一段文本的字体。如果不指定该属性,则默认为12-point Helvetica(Neue)。
NSParagraphStyleAttributeName
该属性所对应的值是一个 NSParagraphStyle 对象。该属性在一段文本上应用多个属性。如果不指定该属性,则默认为 NSParagraphStyle 的defaultParagraphStyle 方法返回的默认段落属性。
NSForegroundColorAttributeName
该属性所对应的值是一个 UIColor 对象。该属性用于指定一段文本的字体颜色。如果不指定该属性,则默认为黑色。
NSBackgroundColorAttributeName
该属性所对应的值是一个 UIColor 对象。该属性用于指定一段文本的背景颜色。如果不指定该属性,则默认无背景色。
NSLigatureAttributeName
该属性所对应的值是一个 NSNumber 对象(整数)。连体字符是指某些连在一起的字符,它们采用单个的图元符号。0 表示没有连体字符。1 表示使用默认的连体字符。2表示使用所有连体符号。默认值为 1(注意,iOS 不支持值为 2)。
NSKernAttributeName
该属性所对应的值是一个 NSNumber 对象(整数)。字母紧排指定了用于调整字距的像素点数。字母紧排的效果依赖于字体。值为 0 表示不使用字母紧排。默认值为0。
NSStrikethroughStyleAttributeName
该属性所对应的值是一个 NSNumber 对象(整数)。该值指定是否在文字上加上删除线,该值参考“Underline Style Attributes”。默认值是NSUnderlineStyleNone。
NSUnderlineStyleAttributeName
该属性所对应的值是一个 NSNumber 对象(整数)。该值指定是否在文字上加上下划线,该值参考“Underline Style Attributes”。默认值是NSUnderlineStyleNone。
NSStrokeColorAttributeName
该属性所对应的值是一个 UIColor 对象。如果该属性不指定(默认),则等同于 NSForegroundColorAttributeName。否则,指定为删除线或下划线颜色。更多细节见“Drawing attributedstrings that are both filled and stroked”。
NSStrokeWidthAttributeName
该属性所对应的值是一个 NSNumber 对象(小数)。该值改变描边宽度(相对于字体size 的百分比)。默认为 0,即不改变。正数只改变描边宽度。负数同时改变文字的描边和填充宽度。例如,对于常见的空心字,这个值通常为3.0。
NSShadowAttributeName
该属性所对应的值是一个 NSShadow 对象。默认为 nil
NSVerticalGlyphFormAttributeName
该属性所对应的值是一个 NSNumber 对象(整数)。0 表示横排文本。1 表示竖排文本。在 iOS 中,总是使用横排文本,0 以外的值都未定义。
个人感觉,项目里面使用它的频率还是比较高的,有时候会写一些公共的方法在整个项目里面使用!
以上是关于NSAttributedString的主要内容,如果未能解决你的问题,请参考以下文章
如何绘制围绕特定点旋转的 NSAttributedString?
使用 NSAttributedString 更改字符串颜色?
Swift 4.2 类型“NSAttributedString.Key”没有成员“accessibilitySpeechPitch”