[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, width: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 時通過 \n 進行手動換行。
        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
    }
}