[Swift]最强UIButton解析 | #selector()绑定点击事件

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/ ）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10869372.html 
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

函数参数既可以具有名称（在函数体内使用），也可以具有参数标签（在调用函数时使用）。

如函数参数标签和参数名称中所述。方法参数也是如此，因为方法只是与类型相关联的函数。

//
//  ViewController.swift
//  demo
//
//  Created by qiang zeng on 2020/2/20.
//  Copyright © 2020 strengthen All rights reserved.
//

import UIKit

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        //初始化一个按钮
        let button:UIButton = getButton()
        //将按钮添加到视图中
        self.view.addSubview(button)
        
        //设置按钮的点击事件：button.addTarget(Any?, action: Selector, for: UIControlEvents)
        //1、touchDown：单点触摸按下事件，点触屏幕
        //2、touchDownRepeat：多点触摸按下事件，点触计数大于1，按下第2、3或第4根手指的时候
        //3、touchDragInside：触摸在控件内拖动时
        //4、touchDragOutside：触摸在控件外拖动时
        //5、touchDragEnter：触摸从控件之外拖动到内部时
        //6、touchDragExit：触摸从控件内部拖动到外部时
        //7、touchUpInside：在控件之内触摸并抬起事件
        //8、touchUpOutside：在控件之外触摸抬起事件
        //9、touchCancel：触摸取消事件，即一次触摸因为放上太多手指而被取消，或者电话打断
        
        //按钮绑定点击事件,无参数传递方式1
        button.addTarget(self, action: #selector(buttonClick1), for: .touchUpInside)
        button.addTarget(self, action: #selector(buttonClick2), for: .touchUpInside)
        button.addTarget(self, action: #selector(buttonClick3), for: .touchUpInside)
        //按钮绑定点击事件,无参数传递方式2
        //Swift提倡用方式2
        button.addTarget(self, action: #selector(ViewController.buttonClick1), for: .touchUpInside)
        button.addTarget(self, action: #selector(ViewController.buttonClick2), for: .touchUpInside)
        button.addTarget(self, action: #selector(ViewController.buttonClick3), for: .touchUpInside)
        
        //按钮绑定点击事件,带button参数传递
        //与点击方法的参数相同，无参数标签使用参数名称，传递点击的按钮
        button.addTarget(self, action: #selector(buttonClick2(button:)), for: .touchUpInside)
        
        //与点击方法的参数相同，有参数标签使用参数标签
        button.addTarget(self, action: #selector(buttonClick3(_ :)), for: .touchUpInside)
    }
    
    //MARK:按钮点击1
    @objc func buttonClick1()
    {
        //TODO
    }
    
    //MARK:按钮点击2
    @objc func buttonClick2(button:UIButton)
    {
        //TODO
    }
    
    //MARK:按钮点击3
    @objc func buttonClick3(_ button:UIButton)
    {
        //TODO
    }
    
    //MARK:获取按钮
    func getButton() -> UIButton
    {
        //1、UIButtonType.system：前面不带图标，默认文字颜色为蓝色，有触摸时的高亮效果
        //2、UIButtonType.custom：定制按钮，前面不带图标，默认文字颜色为白色，无触摸时的高亮效果
        //3、UIButtonType.contactAdd：前面带“+”图标按钮，默认文字颜色为蓝色，有触摸时的高亮效果
        //4、UIButtonType.detailDisclosure：前面带“!”图标按钮，默认文字颜色为蓝色，有触摸时的高亮效果
        //5、UIButtonType.infoDark：为感叹号“!”圆形按钮
        //6、UIButtonType.infoLight：为感叹号“!”圆形按钮
        let button:UIButton = UIButton(type:.custom)
        
        //设置按钮的坐标和显示区域
        button.frame = CGRect(x:50, y:50, 50,height: 50)
        //设置按钮的背景颜色
        button.backgroundColor = UIColor.red
        //设置按钮背景图片：button.setBackgroundImage(UIImage?, for: UIControlState)
        button.setBackgroundImage(UIImage(named:"bg"), for: .normal)
        //设置按钮字体和大小
        button.titleLabel?.font = UIFont.init(name:"Arial",size:16)
        //设置字体大小
        button.titleLabel?.font = UIFont.systemFont(ofSize: 22)
        //Tag
        button.tag = 1
        //高亮状态
        button.isHighlighted = true
        //设置镂空图片的颜色
        button.tintColor = UIColor.white
        //设置圆角
        button.layer.masksToBounds = true
        //圆角半径
        button.layer.cornerRadius = 10
        //边框粗细
        button.layer.borderWidth = 0.5
        //设置边框
        button.layer.borderColor = UIColor.black.cgColor
        
        //设置按钮不同状态下的文字、颜色和阴影颜色
        //1、UIControlState.normal//普通状态
        //2、UIControlState.highlighted//触摸状态
        //3、UIControlState.disabled//禁用状态
        //设置各个状态的文字内容
        button.setTitle("普通状态", for: .normal)
        button.setTitle("触摸状态", for: .highlighted)
        button.setTitle("禁用状态", for: .disabled)
        //设置各个状态下文字阴影的颜色
        button.setTitleShadowColor(UIColor.green, for:.normal)
        button.setTitleShadowColor(UIColor.yellow, for:.highlighted)
        button.setTitleShadowColor(UIColor.gray, for:.disabled)

        //设置按钮图标：button.setImage(UIImage?, for: UIControlState)
        //当按钮类型为custom，处于highlighted和disable状态下图标会变暗，
        //可以通过设置来禁用这种情况
        button.setImage(UIImage(named:"img"), for: .normal)
        button.adjustsImageWhenHighlighted = false //使触摸模式下按钮也不会变暗
        button.adjustsImageWhenDisabled = false //使禁用模式下按钮也不会变暗
        
        //按钮文字太长处理方式：titleLabel 的 lineBreakMode 属性
        //byTruncatingHead：省略头部文字，省略部分用...代替
        //byTruncatingMiddle：省略中间部分文字，省略部分用...代替（默认）
        //byTruncatingTail：省略尾部文字，省略部分用...代替
        //byClipping：直接将多余的部分截断
        //byWordWrapping：自动换行（按词拆分）
        //byCharWrapping：自动换行（按字符拆分）
        //注意：当设置自动换行后（byWordWrapping 或 byCharWrapping），我们可以在设置 title 时通过 
 进行手动换行。
        button.titleLabel?.lineBreakMode = .byWordWrapping

        //调整文字和图标之间的间距：通过图片偏移量（imageEdgeInsets）设置间距
        button.imageEdgeInsets = UIEdgeInsets(top: 0, left: -10, bottom: 0, right: 0)
        //通过文字偏移量（titleEdgeInsets）设置间距
        button.titleEdgeInsets = UIEdgeInsets(top: 0, left: 10, bottom: 0, right: 0)
        //调换或调整文字和图片位置：通过设置 titleEdgeInsets 和 imageEdgeInsets 即可实现。
        let imageSize = button.imageRect(forContentRect: button.frame)//获取图标的CGRect
        let titleFont = button.titleLabel?.font//获取字体
        let titleSize = button.currentTitle!.size(withAttributes:[NSAttributedString.Key.font: titleFont!])//获取文字的尺寸
        button.titleEdgeInsets = UIEdgeInsets(top: 0, left: -(imageSize.width * 2) , bottom: 0, right: 0)
        button.imageEdgeInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: -(titleSize.width * 2 + 10))
        
        //扩展方法示例：快速的设置图片和文字的相对位置，以及间距
        button.set(icon: UIImage(named:"img"), title: "标题", titleLocation: .top, padding: 10, state: .normal)
        return button
    }
}

//MARK:
extension UIButton{
    func set(icon image: UIImage?, title: String, titleLocation: UIView.ContentMode, padding: CGFloat, state: UIControl.State ) {
        self.imageView?.contentMode = .center
        self.setImage(image, for: state)
        relativeLocation(title: title, location: titleLocation, padding: padding)
        self.titleLabel?.contentMode = .center
        self.setTitle(title, for: state)
    }
    
    private func relativeLocation(title: String, location: UIView.ContentMode, padding: CGFloat){
        let imageSize = self.imageRect(forContentRect: self.frame)
        let titleFont = self.titleLabel?.font!
        let titleSize = title.size(withAttributes: [NSAttributedString.Key.font : titleFont!])
        
        var titleInsets: UIEdgeInsets
        var imageInsets: UIEdgeInsets
        
        switch location {
        case .top:
            titleInsets = UIEdgeInsets(top: -(imageSize.height + titleSize.height + padding),
                                       left: -(imageSize.width), bottom: 0, right: 0)
            imageInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: -titleSize.width)
        case .left:
            titleInsets = UIEdgeInsets(top: 0, left: -(imageSize.width * 2), bottom: 0, right: 0)
            imageInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: -(titleSize.width * 2 + padding))
        case .bottom:
            titleInsets = UIEdgeInsets(top: (imageSize.height + titleSize.height + padding),
                                       left: -(imageSize.width), bottom: 0, right: 0)
            imageInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: -titleSize.width)
        case .right:
            titleInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: -padding)
            imageInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
        default:
            titleInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
            imageInsets = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
        }
        self.titleEdgeInsets = titleInsets
        self.imageEdgeInsets = imageInsets
    }
}