iOS开发之UI篇（7）—— UIButton

版本

Xcode 9.1

继承关系：

UIButton : UIControl : UIView : UIResponder : NSObject

一、创建方法

通常，我们创建一个对象会使用[[class alloc] init];方法，但对于UIButton是不推荐使用此方法的。原因有二：

• UIButton有个按钮样式属性buttonType需要在初始化的时候设定好，代码后期无法改变。假如使用alloc创建，那么buttonType默认为Custom模式。（关于buttonType详见后文）
• MRC下，如果使用 [[UIButton alloc] init]的方式，需要进行release释放操作；如果使用[UIButton buttonWithType:(UIButtonType)]这种方式，不需要进行release操作。

所以，代码创建UIButton方法为：

[UIButton buttonWithType:(UIButtonType)];

二、按钮样式（UIButtonType）

UIButtonType有六种枚举类型，对应外观如下：

之所以选择样式，是为了使用该样式下已经默认设置好的一些属性。
如Add Contact是一个“+”添加图形。而Detail Disclosure、Info Light及Info Dark都是一个“i”信息图形，Info Light和Info Dark这俩货之间我实在找不到有什么异样，但是这俩货与DetailDisclosure或者其他样式的区别是：这俩货默认属性showsTouchWhenHighlighted=YES，这就使得在点击按钮的时候（高亮状态），这俩货会散发出白色的光芒！将背景色调成黑色看看效果：

点击Info Light样式按钮

最后来说说System和Custom这两个样式。对于System样式，系统为我们预设了一些属性（详见下文对比部分）。Custom顾名思义是自定义的，可设置更多属性。如果我们在storyboard中设置Detail Disclosure、Info Light、Info Dark或者Add Contact按钮的title、backgroundImage等属性，会发现他们马上变成Custom样式；而如果设置了所有非Custom按钮的image（前景图片）属性，那么这些按钮也都将变成Custom样式。说明Custom可操作的属性还是比较多的。

System和Custom样式对比：

1. 对于字体颜色
System默认普通状态下为蓝色；Custom默认白色。
2. 对于前景image
Custom样式下可以显示前景图片，见图Custom；System样式不能显示前景图片，变成了图System这衰样…

Custom

System

3. 对于属性adjustsImageWhenHighlighted

@property(nonatomic) BOOL adjustsImageWhenHighlighted;    // default is YES. if YES, image is drawn darker when highlighted(pressed)

从官方注释中可以看到，adjustsImageWhenHighlighted为YES时，使得高亮状态（按钮按下）前景图片和背景图片均会变暗。如果将这个属性值设为NO，按下按钮图片就不会变暗了。
经我亲测，System样式下adjustsImageWhenHighlighted默认为NO，而Custom样式下adjustsImageWhenHighlighted默认才为YES，即此default值说的是Custom样式。
按道理按下System样式的按钮，图片应该不会变暗才对（因为adjustsImageWhenHighlighted默认值为NO），但是它还是变暗了！这是为什么呢？还请接着看第4点。

4. 对于高亮状态下
如果是System样式，高亮状态下（即按下按钮）不止图片变暗，文字也跟着变暗了。即使设置了adjustsImageWhenHighlighted=NO，或者设置了高亮状态图片与普通状态图片一致，也是不行。说明System在高亮状态下还会改变另外一个属性使得按钮变暗。但是笔者却找不出是哪个属性改变了，估计看官已经气愤难当磨刀霍霍了…
如果是Custom，文字不管在哪种状态都不会变暗。而图片会因为adjustsImageWhenHighlighted默认值为YES变暗，设置为NO就不变暗了。

三、按钮属性

一般来说，我们设置对象属性都会使用点语法，但对于UIButton来说，有些属性是不能使用点语法的。

设置属性注意事项

1. UIButton的非私有属性（继承而来的属性），可以使用点语法。
如：

    btn.frame = CGRectMake(100, 100, 200, 50);      // 设置位置尺寸
    btn.backgroundColor = [UIColor purpleColor];    // 设置背景颜色
    btn.alpha = 1.0f;                               // 设置透明度
    btn.layer.cornerRadius = 5.0;                   // 设置圆角（5.0是圆角的弧度）
    btn.layer.borderWidth = 1.0f;                   // 设置边框宽度
    btn.layer.borderColor = [UIColor blackColor].CGColor;   //设置边框颜色
    btn.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter;         // 设置垂直方向对齐方式
    btn.contentHorizontalAlignment = UIControlContentHorizontalAlignmentCenter;     // 设置水平方向对齐模式

2. UIButton的私有属性大多为只读，不能使用点语法进行set设置。
UIButton中所有只读属性：

@property(nonatomic,readonly) UIButtonType buttonType;
@property(nullable, nonatomic,readonly,strong) NSString *currentTitle;             // normal/highlighted/selected/disabled. can return nil
@property(nonatomic,readonly,strong) UIColor  *currentTitleColor;        // normal/highlighted/selected/disabled. always returns non-nil. default is white(1,1)
@property(nullable, nonatomic,readonly,strong) UIColor  *currentTitleShadowColor;  // normal/highlighted/selected/disabled.
@property(nullable, nonatomic,readonly,strong) UIImage  *currentImage;             // normal/highlighted/selected/disabled. can return nil
@property(nullable, nonatomic,readonly,strong) UIImage  *currentBackgroundImage;   // normal/highlighted/selected/disabled. can return nil
@property(nullable, nonatomic,readonly,strong) NSAttributedString *currentAttributedTitle NS_AVAILABLE_IOS(6_0);  // normal/highlighted/selected/disabled. can return nil
@property(nullable, nonatomic,readonly,strong) UILabel     *titleLabel NS_AVAILABLE_IOS(3_0);
@property(nullable, nonatomic,readonly,strong) UIImageView *imageView  NS_AVAILABLE_IOS(3_0);

3. UIButton有几种显示状态（普通、高亮、选中等），每种状态对应的某些属性是不同的，如果使用点语法就无法指明是哪种状态下的属性
比如设置以下属性的时候需同时表明是在哪个状态（State）：

// 设置标题
- (void)setTitle:(nullable NSString *)title forState:(UIControlState)state;                     // default is nil. title is assumed to be single line
// 设置标题颜色
- (void)setTitleColor:(nullable UIColor *)color forState:(UIControlState)state UI_APPEARANCE_SELECTOR; // default if nil. use opaque white
// 设置标题阴影颜色
- (void)setTitleShadowColor:(nullable UIColor *)color forState:(UIControlState)state UI_APPEARANCE_SELECTOR; // default is nil. use 50% black
// 设置前景图片
- (void)setImage:(nullable UIImage *)image forState:(UIControlState)state;                      // default is nil. should be same size if different for different states
// 设置背景图片
- (void)setBackgroundImage:(nullable UIImage *)image forState:(UIControlState)state UI_APPEARANCE_SELECTOR; // default is nil
// 设置带属性的标题（NSAttributedString类型），设置麻烦不常用。
- (void)setAttributedTitle:(nullable NSAttributedString *)title forState:(UIControlState)state NS_AVAILABLE_IOS(6_0); // default is nil. title is assumed to be single line

读取属性

1. 获取当前状态的属性
使用点语法获取只读属性，如：

btn. currentTitle、btn. currentImage 等等

2. 获取指定状态的属性
使用对象方法返回属性：

- (nullable NSString *)titleForState:(UIControlState)state;          // these getters only take a single state value
- (nullable UIColor *)titleColorForState:(UIControlState)state;
- (nullable UIColor *)titleShadowColorForState:(UIControlState)state;
- (nullable UIImage *)imageForState:(UIControlState)state;
- (nullable UIImage *)backgroundImageForState:(UIControlState)state;
- (nullable NSAttributedString *)attributedTitleForState:(UIControlState)state NS_AVAILABLE_IOS(6_0);

内容对齐方式

因为UIButton继承自UIControl，而UIControl提供两个属性UIControlContentHorizontalAlignment和UIControlContentVerticalAlignment分别用来设置水平方向和垂直方向的对齐方式，对应效果如下：

UIButton中image与backgroundImage区别

由于System样式的按钮不显示前景图片（前文有演示），因此以下均是对Custom样式按钮进行探讨。
1. 层级关系
创建一个带有标题title，前景图片image和背景图片backgroundImage的按钮如下：

运行代码，然后捕捉视图的层级关系：

或者直接点击Xcode底部红框内按钮，然后可以查看当前视图的层级关系：

小结一下：
- 视图Z轴方向由里向外依次为backgroundImage–> image–>title
- image默认居左，title默认居右

2. 内容模式
backgroundImage的内容模式（contentMode）默认为UIViewContentModeScaleToFill，backgroundImage会跟随按钮的大小的改变而改变，也就是说背景图片始终等于按钮尺寸。
对于image就比较怪：当图片的宽（或高）小于按钮尺寸时，image显示的是原始宽（或高）；当图片宽（或高）大于按钮尺寸时，image被压缩到与button等宽（或高）的尺寸。这种内容模式我叫不上名儿来。。。
对于image或者backgroundImage的contentMode属性，苹果没有提供修改的途径（至少我没找到）。所以当我们使用image的时候，最好先调好尺寸，对于比较大的图片，先进行必要的压缩裁切。（不过笔者通常不会这么干，如果需要自定义比较高的button，我就直接用view来做外观显示，然后再套上一个透明的button~）

总结

1. 按钮的Z轴方向由里向外依次为backgroundImage–> image–>title
2. image默认居左，title默认居右
3. backgroundImage尺寸永远等于按钮尺寸
4. 对于image：当图片的宽（或高）小于按钮尺寸时，image显示的是原始宽（或高）；当图片宽（或高）大于按钮尺寸时，image被压缩到与button等宽（或高）的尺寸。
5. image和backgroundImage的contentMode属性无法修改。

四、控制状态（UIControlState）

在set按钮的私有属性的时候，通常会一并forState指明在哪个控制状态。那么UIButton总共有几个状态呢？以下是UIControlState枚举值：

typedef NS_OPTIONS(NSUInteger, UIControlState) {
    UIControlStateNormal       = 0,             // 普通状态（按下之前）
    UIControlStateHighlighted  = 1 << 0,        // 高亮状态（按下ing）
    UIControlStateDisabled     = 1 << 1,        // 失效状态（enable=NO）
    UIControlStateSelected     = 1 << 2,        // 选中状态（selected=YES）
    UIControlStateFocused NS_ENUM_AVAILABLE_IOS(9_0) = 1 << 3,  // 聚焦状态（iOS9.0开始引入，应该和3D Touch有关）
    UIControlStateApplication  = 0x00FF0000,    // additional flags available for application use（不明觉厉）
    UIControlStateReserved     = 0xFF000000     // 苹果预留位，憋管它。。。
};

我们看到，与普通的枚举不同，UIControlState是位枚举。也就是说，按钮可以同时拥有不止一个状态！

• if(isSelected == NO)，有两种状态：UIControlStateNormal 和 UIControlStateHighlighted
• if(isSelected == YES)，也有两种状态 UIControlStateSelected 和 UIControlStateSelected | UIControlStateHighlighted

也就是说：当没有选中状态下，按下的时候对应高亮模式（UIControlStateHighlighted）；而当按钮已经是选中状态，此时再按下按钮即对应高亮模式位和选中模式（UIControlStateSelected | UIControlStateHighlighted）。

五、添加事件

前面铺垫了这么多，接下来该讲讲UIButton的主要作用了——响应事件。要响应事件，首先需给button添加对指定事件的监听机制（add target/action），即添加事件。
UIButton能响应的事件（UIControlEvents）有很多，枚举值如下：

    UIControlEventTouchDown             // 单点触摸按下（用户点触屏幕，或者又有新手指落下的时候）
    UIControlEventTouchDownRepeat       // 多点触摸按下（点触计数大于1：用户按下第二、三、或第四根手指的时候）
    UIControlEventTouchDragInside       // 当一次触摸在控件内拖动
    UIControlEventTouchDragOutside      // 当一次触摸在控件外拖动
    UIControlEventTouchDragEnter        // 当一次触摸从控件外拖动到内部
    UIControlEventTouchDragExit         // 当一次触摸从控件内部拖动到外部
    UIControlEventTouchUpInside         // 所有在控件之内触摸抬起
    UIControlEventTouchUpOutside        // 所有在控件之外触摸抬起(点触起始必须落在控件内部才会发送通知)
    UIControlEventTouchCancel           // 所有触摸取消事件（如一次触摸因为放上了太多手指而被取消，或者被上锁或者电话呼入打断）

    UIControlEventValueChanged          // 当控件的值发生改变
    UIControlEventPrimaryActionTriggered NS_ENUM_AVAILABLE_IOS(9_0)    // 当控件的首要行为被触发，例如button的点击事件，slider的滑动事件（iOS9.0引入）

    UIControlEventEditingDidBegin       // 当控件中文本开始编辑时
    UIControlEventEditingChanged        // 当控件中文本发生改变时
    UIControlEventEditingDidEnd         // 当控件中文本编辑结束时
    UIControlEventEditingDidEndOnExit   // 当文本控件内通过按下回车键（或等价行为）结束编辑时

    UIControlEventAllTouchEvents        // 所有触摸事件均触发通知
    UIControlEventAllEditingEvents      // 所有文本编辑事件均触发通知
    UIControlEventApplicationReserved   // 苹果预留给应用使用，不去理会
    UIControlEventSystemReserved        // 苹果预留给内部框架使用，不去理会
    UIControlEventAllEvents             // 所有事件均触发通知

添加事件：

    /**
     添加点击事件

     addTarget:（参数1）    响应目标（由谁来执行响应方法）
     action:（参数2）   调用方法（即响应事件）
     forControlEvents:（参数3） 事件的类型
     */
    [btn addTarget:self action:@selector(btnAction:) forControlEvents:UIControlEventTouchUpInside];

响应方法：

#pragma mark - 按钮响应方法

- (void)btnAction:(UIButton *)btn {

    NSLog(@"点击了按钮");
}

示例

#import "ViewController.h"

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 实例化一个UIButton
    UIButton *btn = [UIButton buttonWithType:UIButtonTypeCustom];

    /* 设置属性 */
    btn.frame = CGRectMake(0, 0, 100, 80 );      // 设置位置尺寸
    btn.center = CGPointMake([UIScreen mainScreen].bounds.size.width/2, [UIScreen mainScreen].bounds.size.height/2);
    btn.backgroundColor = [UIColor purpleColor];    // 设置背景颜色
    btn.alpha = 1.0f;                               // 设置透明度
    btn.layer.cornerRadius = 5.0;                   // 设置圆角（5.0是圆角的弧度）
    btn.layer.borderWidth = 1.0f;                   // 设置边框宽度
    btn.layer.borderColor = [UIColor blackColor].CGColor;   //设置边框颜色
    btn.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter;         // 设置垂直方向对齐方式
    btn.contentHorizontalAlignment = UIControlContentHorizontalAlignmentCenter;     // 设置水平方向对齐模式

    // 设置标题文字
    [btn setTitle:@"普通" forState:UIControlStateNormal];
    [btn setTitle:@"高亮" forState:UIControlStateHighlighted];
    [btn setTitle:@"选中" forState:UIControlStateSelected];
    [btn setTitle:@"选中状态下的高亮" forState:UIControlStateHighlighted|UIControlStateSelected];

    // 设置前景图
//    [btn setImage:[UIImage imageNamed:@"11"] forState:UIControlStateNormal];

    // 设置背景图
    [btn setBackgroundImage:[UIImage imageNamed:@"red"] forState:UIControlStateNormal];
    [btn setBackgroundImage:[UIImage imageNamed:@"goodFilling"] forState:UIControlStateHighlighted];
    [btn setBackgroundImage:[UIImage imageNamed:@"red"] forState:UIControlStateHighlighted|UIControlStateSelected];
    [btn setBackgroundImage:[UIImage imageNamed:@"red"] forState:UIControlStateSelected];

    /**
     添加点击事件

     addTarget:（参数1）    响应目标（由谁来执行响应方法）
     action:（参数2）   调用方法（即响应事件）
     forControlEvents:（参数3） 事件的类型
     */
    [btn addTarget:self action:@selector(btnAction:) forControlEvents:UIControlEventTouchUpInside];

    // 添加btn到self.view
    [self.view addSubview:btn];
}


#pragma mark - 按钮响应方法

- (void)btnAction:(UIButton *)btn {

    NSLog(@"点击了按钮");
}


@end

效果图