UILabel 属性

自学ios3个多月了，刚注册了博客，记录下学习过程。共勉，努力。

//
//  UILabel.h
//  UIKit
//
//  Copyright (c) 2006-2015 Apple Inc. All rights reserved.
//

#import<Foundation/Foundation.h>

#import <CoreGraphics/CoreGraphics.h>

#import <UIKit/UIView.h>

#import <UIKit/UIStringDrawing.h>

#import <UIKit/UIKitDefines.h>

NS_ASSUME_NONNULL_BEGIN

@classUIColor,UIFont;

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

//label文本     默认为空  设置label的文本.

/*

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

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

 label.numberOfLines = [label.text length];
 */

@property(nullable,nonatomic,copy)
  NSString          *text;           //
default is nil

//文字大小     默认字体大小为17
@property(null_resettable,nonatomic,strong)UIFont     
*font;           // default is nil (system font 17 plain)

//文字颜色    默认为黑色
@property(null_resettable,nonatomic,strong)UIColor   
*textColor;      // default is nil (text draws black)

//label的阴影颜色
@property(nullable,nonatomic,strong)UIColor           
*shadowColor;    // default is nil (no shadow)

//设置阴影的偏移量
@property(nonatomic)       CGSize           
shadowOffset;   // default is CGSizeMake(0, -1) -- a top shadow

//设置文本对齐格式
@property(nonatomic)       NSTextAlignment   
textAlignment;  // default is NSTextAlignmentLeft

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

/*

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

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

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

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

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

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

 label.lineBreakMode = NSLineBreakByTruncatingMiddle;中间的内容

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

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

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

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

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

@property(nonatomic)       NSLineBreakMode   
lineBreakMode;  // default is NSLineBreakByTruncatingTail. used for single and multiple lines of text

// the underlying attributed string drawn by the label, if set, the label ignores the properties above.

//设置标签属性文本。

/*

 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 *attributedTextNS_AVAILABLE_IOS(6_0); //
default is nil

// the 'highlight' property is used by subclasses for such things as pressed states. it's useful to make it part
of the base class as a user property
//显示高亮文本颜色
@property(nullable,nonatomic,strong)
              UIColor *highlightedTextColor;//
default is nil

//是否显示高亮
@property(nonatomic,getter=isHighlighted)BOOL   
highlighted;         // default is NO

//是否可以与用户交互

@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
minimumScaleFactorNS_AVAILABLE_IOS(6_0);//
default is 0.0

//myLabel.allowsDefaultTighteningForTruncation = YES;这个属性是用来设置多行label的最大宽度的当自动布局的时候约束这个label的时候这个属性会起作用在自动布局添加约束中，若文本超过了指定的最大宽度的时候
文本会另起一行 从而增加了label的高度myLabel.preferredMaxLayoutWidth = 20;
@property(nonatomic)BOOL
allowsDefaultTighteningForTruncationNS_AVAILABLE_IOS(9_0);//
default is NO
// Support for constraint-based layout (auto layout)
// If nonzero, this is used when determining -intrinsicContentSize for multiline labels
@property(nonatomic)CGFloat
preferredMaxLayoutWidthNS_AVAILABLE_IOS(6_0);

／*

计算UIlabel 随字体多行后的高度

CGRect
result,bounds;

bounds
= CGRectMake(0, 0,200, 300);

heightLabel
= [myLabel textRectForBounds:bounds limitedToNumberOfLines:20];

//计算20行后的Label的Frame

NSLog(@

"%f"

,heightLabel.size.height);

*/
- (CGRect)textRectForBounds:(CGRect)bounds
limitedToNumberOfLines:(NSInteger)numberOfLines;
//需要重载此方法，然后由子类调用，重写时调用super可以按默认图形属性绘制,若自己完全重写绘制函数,就不用调用super了
- (void)drawTextInRect:(CGRect)rect;

//设置最小收缩字号，如果Label宽度小于文字长度时，文字字号减小，低于设定字号后，不再减小。6.0以后不再使用了。
@property(nonatomic)CGFloat
minimumFontSizeNS_DEPRECATED_IOS(2_0,6_0)__TVOS_PROHIBITED;//
deprecated - use minimumScaleFactor. default is 0.0

//改变字母之间的间距来适应Label大小
@property(nonatomic)BOOL
adjustsLetterSpacingToFitWidthNS_DEPRECATED_IOS(6_0,7_0)__TVOS_PROHIBITED;

@end

NS_ASSUME_NONNULL_END