一 、UIBarButtonItem 介绍
UIBarButtonItem 是一个继承与 UIBarItem 的一个类，常用语导航栏的左右按钮。
二 、 UIBarButtonItem 的方法说明
1、初始化的方法
》》 init 创建一个对象
public init()
》》init?(coder aDecoder: NSCoder) 内存记录创建一个对象
public init?(coder aDecoder: NSCoder)
》》生成只是图片的对象
public convenience init(image: UIImage?, style: UIBarButtonItemStyle, target: Any?, action: Selector?)
》》生成一个只含有图片的对象，并且可以在状态栏显示的图像
public convenience init(image: UIImage?, landscapeImagePhone: UIImage?, style: UIBarButtonItemStyle, target: Any?, action: Selector?)
》》生成一个只含所有文字的对象
public convenience init(title: String?, style: UIBarButtonItemStyle, target: Any?, action: Selector?)
》》通过系统的UIBarButtonSystemItem 来创一个对象
public convenience init(barButtonSystemItem systemItem: UIBarButtonSystemItem, target: Any?, action: Selector?)
》》通过一个View 来创建对象
public convenience init(customView: UIView)
2、对象的创建和展示
1、只含所有图像对象
/**
这种快捷初始化是：只有图片的按钮
*/
let BtnItem2 = UIBarButtonItem.init(image: UIImage.init(named: "back")?.withRenderingMode(.alwaysOriginal), style: .plain, target: self, action: #selector(imageBarButtonItemMethod))
self.navigationItem.leftBarButtonItem = BtnItem2
展示图像
4707D5DF-6CDA-4B27-8D9D-49249BD743FD.png
2、只含有文字的对象
/**
只有文字的初始化
*/
let BtnItem3 = UIBarButtonItem.init(title: "返回", style: .done, target: self, action: #selector(titleBarButtonItemMethod))
self.navigationItem.leftBarButtonItem = BtnItem3
展示图像
889483DD-0859-4E6A-9D82-AF475A017E8D.png
3、 使用UIBarButtonSystemItem来创建对象
/**
显示系统的 UIBarButtonSystemItem ,创建的UIBarButtonItem
*/
let ItmeS = NSMutableArray.init()
for i in 0...24 {
let BtnItem4 = UIBarButtonItem.init(barButtonSystemItem: UIBarButtonSystemItem(rawValue: i)!, target: self, action: #selector(systemItemBarButtonItemMethod))
ItmeS.add(BtnItem4)
}
self.navigationItem.leftBarButtonItems = (ItmeS as! [UIBarButtonItem])
展示图片
4、当导航栏紧凑的时候，按钮图片将会显示到状态栏里
/**
landscapeImagePhone将用于工具栏按钮图像当导航栏紧凑或浓缩栏指标。
*/
let BtnItem5 = UIBarButtonItem.init(image: UIImage.init(named: "back")?.withRenderingMode(.alwaysOriginal), landscapeImagePhone: UIImage.init(named: "back")?.withRenderingMode(.alwaysOriginal), style: .done, target: self, action: #selector(landscapeImageBarButtonItemMethod))
self.navigationItem.leftBarButtonItem =BtnItem5
5、这些按钮还可以一起显示在导航上
let BtnItem2 = UIBarButtonItem.init(image: UIImage.init(named: "back")?.withRenderingMode(.alwaysOriginal), style: .plain, target: self, action: #selector(imageBarButtonItemMethod))
let BtnItem3 = UIBarButtonItem.init(title: "返回", style: .done, target: self, action: #selector(titleBarButtonItemMethod))
let BtnItem4 = UIBarButtonItem.init(barButtonSystemItem: .bookmarks, target: self, action: #selector(systemItemBarButtonItemMethod))
self.navigationItem.leftBarButtonItems = [BtnItem2,BtnItem3,BtnItem4]
展示图片
9765C96A-A610-49FA-8885-F870674E154D.png
3、属性的说明和使用
1、设置UIBarButtonItem按钮的文字颜色,不影响图片
BtnItem3.tintColor = UIColor.red
图像展示
6C32274B-A55D-4CC8-A040-F8CD34B0F2D7.png
2、设置背景图片 & 获取背景图片
》#设置图片
/**
设置UIBarButtonItem的背景图片
*/
BtnItem3.setBackgroundImage(UIImage.init(named: "2"), for: .normal, barMetrics: .default)
图像展示
1BC0EC3C-6A49-47D9-B892-8F06DBCD0BC9.png
》#获取图像
/**
获取设置的背景图片
*/
let backBtnItemImage = BtnItem3.backgroundImage(for: .normal, barMetrics: .default)
print(backBtnItemImage!)
3、设置按钮的文字的显示位置
/**
设置UIBarButtonItem文字在按钮框内的位置
horizontal >0 文字显示在水平中心偏右的位置
horizontal <0 文字显示在水平中心偏左的位置
vertical > 0 文字显示在垂直中心偏上的位置
vertical < 0 文字显示在垂直中心偏下的位置
*/
BtnItem3.setTitlePositionAdjustment(UIOffset.init(horizontal: 0, vertical: 0), for: .default)
4、调整按钮在导航栏的垂直位置
/**
条件是:self.navigationController?.navigationBar.frame 的高度大于系统默认设置的高度时才有效。
调整按钮的垂直位置
*/
BtnItem2.setBackgroundVerticalPositionAdjustment(-40, for: .default)
let adjustmentValue = BtnItem2.backButtonTitlePositionAdjustment(for: .default)
print(adjustmentValue)
图像展示
BC6C1F5C-6C7C-4572-8692-1927769CF4B9.png
5 、一个未测试出来的方法
BtnItem3.setBackButtonBackgroundVerticalPositionAdjustment(-140, for: .default)
let VerticalPositionAdjustmentValue = BtnItem3.backButtonBackgroundVerticalPositionAdjustment(for: .default)
print(VerticalPositionAdjustmentValue)
6、全局改变按钮文字的颜色或者样式的方法
UIBarButtonItem.appearance().setTitleTextAttributes([NSFontAttributeName:UIFont.boldSystemFont(ofSize: 20),NSForegroundColorAttributeName:UIColor.red], for: .normal)