iOS－UIKit( UILabel.h - -解读)

NS_ASSUME_NONNULL_BEGIN

@class UIColor,UIFont;

NS_CLASS_AVAILABLE_IOS(2_0)@interface UILabel :UIView <NSCoding>

//设置和读取文本内容,默认为nil

/*

 竖排文字显示每个文字加一个换行符，这是最方便和简单的实现方式。

 label.text = @"请\n竖\n直\n方\n向\n排\n列";

 label.numberOfLines = [label.text length];

 */

@property(nullable,nonatomic,copy)NSString *text;

//设置字体大小，默认17

@property(null_resettable,nonatomic,strong)UIFont*font;

//设置文字颜色，默认为黑色

@property(null_resettable,nonatomic,strong)UIColor*textColor;

//设置阴影颜色 

@property(nullable,nonatomic,strong)UIColor*shadowColor;

//设置阴影偏移量

@property(nonatomic)CGSize shadowOffset;

//设置标签文本对齐方式。

@property(nonatomic)NSTextAlignment textAlignment;

//设置文字过长时的显示格式

/*

 label.lineBreakMode = NSLineBreakByCharWrapping;以字符为显示单位显

 示，后面部分省略不显示。

 label.lineBreakMode = NSLineBreakByClipping;剪切与文本宽度相同的内

 容长度，后半部分被删除。

 label.lineBreakMode = NSLineBreakByTruncatingHead;前面部分文字

 以……方式省略，显示尾部文字内容。

 label.lineBreakMode = NSLineBreakByTruncatingMiddle;中间的内容

 以……方式省略，显示头尾的文字内容。

 label.lineBreakMode = NSLineBreakByTruncatingTail;结尾部分的内容

 以……方式省略，显示头的文字内容。

 label.lineBreakMode = NSLineBreakByWordWrapping;以单词为显示单位显

 示，后面部分省略不显示。

 */

@property(nonatomic)NSLineBreakMode lineBreakMode;

//设置标签属性文本。

/*

 NSMutableAttributedString*attriString=[[NSMutableAttributedString alloc]initWithString:@"this is test!"];

 [attriString addAttributes:@{NSForegroundColorAttributeName:[UIColor redColor]} range:NSMakeRange(0, 4)];

 [attriString addAttributes:@{NSForegroundColorAttributeName:[UIColor greenColor]} range:NSMakeRange(8, 4)];

 //改变this的字体，value必须是一个CTFontRef

 [attriString addAttribute:(NSString *)kCTFontAttributeName

 value:(id)CFBridgingRelease(CTFontCreateWithName((CFStringRef)[UIFont boldSystemFontOfSize:14].fontName,14,NULL))range:NSMakeRange(0, 4)];

 //给this加上下划线，value可以在指定的枚举中选择

 [attriString addAttribute:(NSString *)kCTUnderlineStyleAttributeName

 value:(id)[NSNumber numberWithInt:kCTUnderlineStyleDouble]

 range:NSMakeRange(0, 4)];

 UILabel*Label=[[UILabel alloc]initWithFrame:CGRectMake(100, 100, 200, 30)];

 Label.attributedText=attriString;

 [self.view addSubview:Label];

 */

@property(nullable,nonatomic,copy)NSAttributedString *attributedText 

//高亮显示时的文本颜色

@property(nullable,nonatomic,strong)UIColor *highlightedTextColor;

//是否高亮显示

@property(nonatomic,getter=isHighlighted)BOOL highlighted; 

//是否可以与用户交互

@property(nonatomic,getter=isUserInteractionEnabled)BOOL userInteractionEnabled; 

//只是决定了Label的绘制方式，将它设置为NO将会使文本变暗，表示它没有激活，这时向它设置颜色值是无效的。

@property(nonatomic,getter=isEnabled)BOOL enabled;

//标签最多显示行数,如果为0则表示多行。

@property(nonatomic)NSInteger numberOfLines;

//设置字体大小适应label宽度 

@property(nonatomic)BOOL adjustsFontSizeToFitWidth; 

//如果adjustsFontSizeToFitWidth属性设置为YES，这个属性就来控制文本基线的行为。

/*

 UIBaselineAdjustmentAlignBaselines = 0,默认，文本最上端与中线对齐。

 UIBaselineAdjustmentAlignCenters,  文本中线与label中线对齐。

 UIBaselineAdjustmentNone, 文本最低端与label中线对齐。

 */

@property(nonatomic)UIBaselineAdjustment baselineAdjustment;

//设置最小收缩比例，如果Label宽度小于文字长度时，文字进行收缩，收缩超过比例后，停止收缩。

@property(nonatomic)CGFloat minimumScaleFactor NS_AVAILABLE_IOS(6_0); 

@property(nonatomic)BOOL allowsDefaultTighteningForTruncation NS_AVAILABLE_IOS(9_0); 

- (CGRect)textRectForBounds:(CGRect)bounds limitedToNumberOfLines:(NSInteger)numberOfLines;

- (void)drawTextInRect:(CGRect)rect;

@property(nonatomic)CGFloat preferredMaxLayoutWidth NS_AVAILABLE_IOS(6_0);

//设置最小收缩字号，如果Label宽度小于文字长度时，文字字号减小，低于设定字号后，不再减小。6.0以后不再使用了。

@property(nonatomic)CGFloat minimumFontSize NS_DEPRECATED_IOS(2_0, 6_0);

//改变字母之间的间距来适应Label大小

@property(nonatomic)BOOL adjustsLetterSpacingToFitWidth NS_DEPRECATED_IOS(6_0,7_0);

@end

NS_ASSUME_NONNULL_END