NSSplitView — 分屏視圖:在水平/垂直方向的線性堆棧中排列 兩個或多個視圖!
分屏視圖也可以管理 分屏視圖控制器(NSSplitViewController)的分屏和方向。默認情況下,分隔條有一個水平方向,這樣分屏視圖就可以從上到下垂直排列它的窗格 —— 如果vertical屬性為NO(默認值),則頂部分隔條的索引為0。如果vertical為YES,則前導分隔條的索引為0。
必須使用NSSplitView實例,來放置NSSplitViewController的(view
屬性或splitView
屬性)視圖:
//必須使用NSSplitView實例,來放置NSSplitViewController的視圖
let sigV = NSSplitView(frame: NSMakeRect(10, 10, 200, 200))
self.view .addSubview(sigV)
sigV.wantsLayer = true
sigV.layer?.backgroundColor = NSColor.purple.cgColor
let splitVC = NSSplitViewController()
splitVC.view.wantsLayer = true
splitVC.view.layer?.backgroundColor = NSColor.cyan.cgColor
self .addChild(splitVC)
sigV .addSubview(splitVC.view)//?
//sigV .addSubview(splitVC.splitView)//?
let subVC1 = GYHViewController()
subVC1.view.wantsLayer = true
subVC1.view.layer?.backgroundColor = NSColor.red.cgColor
let subVC2 = GYHViewController()
subVC2.view.wantsLayer = true
subVC2.view.layer?.backgroundColor = NSColor.blue.cgColor
//添加分屏視圖的子項
let splitV_Item1 = NSSplitViewItem(viewController: subVC1)
let splitV_Item2 = NSSplitViewItem(viewController: subVC2)
splitVC .addSplitViewItem(splitV_Item1)
splitVC .addSplitViewItem(splitV_Item2)
效果:子視圖可以設置其分屏大小!
直接使用NSSplitView:(不通過分屏視圖控制器(NSSplitViewController))
添加子視圖,會(默認)依次填滿NSSplitView實例 — 按子視圖的比例對應尺寸!
let totalV = NSSplitView(frame: NSMakeRect(20, 20, 100, 300))
self.view .addSubview(totalV)
//添加了子視圖,會(默認)依次填滿NSSplitView實例——按子視圖比例的對應尺寸
let leftV = NSView(frame: NSMakeRect(10, 10, 100, 100))
totalV .addSubview(leftV)
leftV.wantsLayer = true
leftV.layer?.backgroundColor = NSColor.red.cgColor
let midV = NSView(frame: NSMakeRect(10, 10, 150, 150))
totalV .addSubview(midV)
midV.wantsLayer = true
midV.layer?.backgroundColor = NSColor.yellow.cgColor
let rightV = NSView(frame: NSMakeRect(10, 10, 200, 200))
totalV .addSubview(rightV)
rightV.wantsLayer = true
rightV.layer?.backgroundColor = NSColor.cyan.cgColor
//totalV .arrangesAllSubviews = false//是否分欄化——默認為YES
totalV.wantsLayer = true
//設置邊框及邊框顏色
totalV.layer?.borderWidth = 3.0
totalV.layer?.borderColor = NSColor.black.cgColor
效果:
設置NSSplitView的(backgroundColor)顏色后,會把‘分割條’顏色(分割條上的點 仍在顯示)覆蓋隱藏掉~
totalV.layer?.backgroundColor = NSColor.blue.cgColor
效果:
為NSSplitView設置分割條是否垂直 — isVertical
屬性(默認為NO)
totalV.isVertical = true//分割條是否垂直(默認為NO)
效果:
也可以給NSSplitView添加約束——子視圖會根據約束,進行等比例的縮放
totalV.translatesAutoresizingMaskIntoConstraints = false//添加約束
let totalV_Lead = totalV.leadingAnchor .constraint(equalTo: self.view.leadingAnchor, constant: 100.0)
let totalV_Trail = totalV.trailingAnchor .constraint(equalTo: self.view.trailingAnchor, constant: -100.0)
let totalV_Top = totalV.topAnchor .constraint(equalTo: self.view.topAnchor, constant: 20.0)
let totalV_Bot = totalV.bottomAnchor .constraint(equalTo: self.view.bottomAnchor, constant: -20)
let totalV_consArr = [totalV_Lead, totalV_Trail, totalV_Top, totalV_Bot]
self.view .addConstraints(totalV_consArr)
效果:對窗口進行縮放時——子視圖會根據約束,進行等比例的縮放!當然子視圖可以設置其分屏大小!
設置分割條的樣式:dividerStyle
屬性
totalV.dividerStyle = NSSplitView.DividerStyle.thin//分割條的樣式
效果:
當在NSSplitView的子視圖 內部,添加一個固定frame的子視圖:(不使用約束布局)
運行效果視圖frame固定,布局上不靈活~
func addConstraintWithInnerView(_ outV: NSView) {
let innerV = NSView(frame: NSMakeRect(10 + (100 + 10), 10, 100, 100))//可以不用設置frame,后續會添加約束
outV .addSubview(innerV)
innerV.translatesAutoresizingMaskIntoConstraints = false//添加約束——一直包含在其父視圖內部
let innerV_Lead = innerV.leadingAnchor .constraint(lessThanOrEqualTo: outV.leadingAnchor, constant: 10.0)
let innerV_Trail = innerV.trailingAnchor .constraint(equalTo:outV.trailingAnchor, constant: -10.0)
let innerV_Top = innerV.topAnchor .constraint(lessThanOrEqualTo: outV.topAnchor, constant: 20.0)
let innerV_Bot = innerV.bottomAnchor .constraint(equalTo: outV.bottomAnchor, constant: -20.0)
let innerV_consArr = [innerV_Lead, innerV_Trail, innerV_Top, innerV_Bot]
outV .addConstraints(innerV_consArr)
innerV.wantsLayer = true
innerV.layer?.backgroundColor = NSColor.purple.cgColor
}
代碼的使用:
//添加上-通過約束布局的子視圖
self .addConstraintWithInnerView(leftV)
self .addConstraintWithInnerView(midV)
self .addConstraintWithInnerView(rightV)
效果:對窗口進行縮放時——子視圖會根據約束,進行等比例的縮放!當然子視圖可以設置其分屏大小,設置其分屏大小后——子視圖仍然會根據約束,進行等比例的縮放!
為NSSplitView實例設置代理——NSSplitViewDelegate
totalV.delegate = self//設置delegate
部分代理方法的響應:
//MARK:NSSplitViewDelegate
func splitView(_ splitView: NSSplitView, shouldAdjustSizeOfSubview view: NSView) -> Bool {
print("shouldAdjustSizeOfSubview \(view.frame)")
return false
}
func splitView(_ splitView: NSSplitView, constrainMaxCoordinate proposedMaximumPosition: CGFloat, ofSubviewAt dividerIndex: Int) -> CGFloat {
print("proposedMaximumPosition:", proposedMaximumPosition, "dividerIndex:", dividerIndex)
if dividerIndex == 0 {//首個視圖(NSView)最大的尺寸
return 150.0
}
return proposedMaximumPosition
}
func splitView(_ splitView: NSSplitView, constrainMinCoordinate proposedMinimumPosition: CGFloat, ofSubviewAt dividerIndex: Int) -> CGFloat {
print("proposedMaximumPosition:", proposedMinimumPosition, "dividerIndex:", dividerIndex)
if dividerIndex == 0 {//首個視圖(NSView)最小的尺寸
return 50.0
}
return proposedMinimumPosition
}
//尺寸變化的通知響應方法
func splitViewDidResizeSubviews(_ notification: Notification) {
//print("notification.object \(notification.object as Any)")
let splitV = notification.object as! NSSplitView//獲取(notification.object)到對應的NSSplitView
print("splitViewDidResizeSubviews splitV \(splitV)")
}
func splitViewWillResizeSubviews(_ notification: Notification) {
//print("notification.object \(notification.object as Any)")
let splitV = notification.object as! NSSplitView//獲取(notification.object)到對應的NSSplitView
print("splitViewWillResizeSubviews splitV \(splitV)")
}
效果:
更多代理方法,參-NSSplitViewDelegate
實現需求 —— 添加一個尺寸不固定的NSTableView
實例對象:
可參考《添加一個尺寸不固定的NSTableView視圖》中第3種方法-使用了NSSplitView實例~
參考資料:
NSSplitView | NSSplitViewController | NSSplitViewDelegate
NSSplitView and autolayout