【Swift】NSScrollView用法和示例
1.NSScrollView 简介
NSScrollView 是 macOS 中一种用于滚动显示内容的视图。 它可以让用户通过拖动视图上的滚动条或使用手势控制滚动。
2.使用 NSScrollView
1. NSScrollView 的基本结构
NSScrollView 由一个滚动区域（contentView）和多个滚动条（scroller）组成。滚动区域是一个 NSView 对象，它包含了实际要显示的内容，可以是任何继承自 NSView 的对象；而滚动条则分为水平滚动条和垂直滚动条，用于控制滚动区域的滚动位置。
通常情况下，我们将要显示的内容加入到滚动区域中，然后将滚动区域添加到 NSScrollView 中。NSScrollView 会根据滚动区域的大小和内容的大小自动调整滚动条的长度和位置，并且当用户滚动滚动条时，NSScrollView 会通过改变滚动区域的位置来实现滚动效果。
2. 创建一个 NSScrollView 对象
创建一个 NSScrollView 对象的方法有两种：
- 通过 Interface Builder 拖拽一个 ScrollView Object 到 Window 中
- 通过代码生成一个 NSScrollView 对象，并将它添加到 Window 的 content view 中。示例代码如下：
// Scroll View 高度
let scrollViewHeight: CGFloat = 200
// Scroll View 宽度
let scrollViewWidth: CGFloat = 300
// 内容区域高度
let contentViewFrame = NSRect(x: 0, y: 0, width: scrollViewWidth, height: scrollViewHeight)
let contentView = NSView(frame: contentViewFrame)
// 初始化ScrollView
let scrollViewFrame = NSRect(x: 0, y: 0, width: scrollViewWidth, height: scrollViewHeight)
let scrollView = NSScrollView(frame: scrollViewFrame)
// 设置ScrollView
scrollView.documentView = contentView
3. 向 ScrollView 中添加可滚动视图
将需要滚动的视图添加到ScrollView 的 ContentView 中。 示例代码中向 ContentView 添加了一个 TextField，添加视图的方式与添加到普通的 NSView 中相同。
let textFieldFrame = NSRect(x: 0, y: 0, width: scrollViewWidth, height: 500)
let textField = NSTextField(frame: textFieldFrame)
contentView.addSubview(textField)
4. 设置 ScrollView 的其他属性
NSScrollView 的常见属性及其作用如下：
| 属性 | 作用 |
| hasVerticalScroller | 是否显示垂直滚动条 |
| hasHorizontalScroller | 是否显示水平滚动条 |
| borderType | 边框类型 |
| backgroundColor | 背景颜色 |
| autohidesScrollers | 滚动条显示方式 |
以下是设置 NSScrollView 的一些常见属性的详细说明：
1. 'hasVerticalScroller' 和 'hasHorizontalScroller'：这两个布尔属性指示 NSScrollView 是否显示垂直和水平滚动条。默认情况下，它们都是 true。
scrollView.hasVerticalScroller = true
scrollView.hasHorizontalScroller = false
2. 'borderType'：这个枚举属性指定 NSScrollView 边框的类型。可以是无边框、线性边框或拼音输入窄边框，默认为线性边框。
scrollView.borderType = .lineBorder
3. 'autohidesScrollers'：这个布尔属性指示 NSScrollView 是否应该自动隐藏滚动条，除非鼠标移动到控件上。默认情况下，它为 true。
scrollView.autohidesScrollers = true
4. 'documentView'：这个属性指定 NSScrollView 内容的视图。这个视图必须是 NSView 类型，而且不能是控制器或其他对象。
let documentView = NSView()
scrollView.documentView = documentView
5. 'contentInsets'：这个属性指定 NSTextContainer 在 NSScrollView 中的距离。可以用来添加额外的空间，以便文本不贴边。
scrollView.contentInsets = NSEdgeInsets(top: 10, left: 10, bottom: 10, right: 10)
6. 'backgroundColor'：这个属性指定 NSScrollView 背景的颜色。
scrollView.backgroundColor = NSColor.white
3. NSScrollView 的注意事项
在使用 NSScrollView 时需要注意以下几点：
- 要正确设置滚动区域的大小和位置，以便 NSScrollView 正确计算滚动条的长度和位置。
- 当改变滚动区域的大小或者内容时，请调用
reflectScrolledClipView:方法更新滚动条的位置。 - 在设置 contentSize 或更新 contentView 大小时，如果想保持原来的滚动位置不变，可以使用
scrollPoint:或scrollRectToVisible:方法。
总的来说，NSScrollView 是一个非常方便的控件，可以帮助我们实现复杂的滚动、缩放等功能。但是在使用过程中需要注意一些细节问题，以避免出现显示异常或者滚动位置不正确等问题。