这节主要通过实践来学习NSTextField的使用,初步了解NSTextField的代理方法、常用属性、常用样式等内容,完整代码可以参看源码目录下的NSTextField_Example项目。

TextField Delegate

NSTextFieldDelegate承继于NSControlTextEditingDelegate,实际常用的只有NSControlTextEditingDelegate,具体内容如下:

1
2
3
4
5
6
7
8
9
10
func controlTextDidBeginEditing(Notification)
func controlTextDidChange(Notification)
func controlTextDidEndEditing(Notification)
func control(NSControl, isValidObject: Any?) -> Bool
func control(NSControl, didFailToValidatePartialString: String, errorDescription: String?)
func control(NSControl, didFailToFormatString: String, errorDescription: String?) -> Bool
func control(NSControl, textShouldBeginEditing: NSText) -> Bool
func control(NSControl, textShouldEndEditing: NSText) -> Bool
func control(NSControl, textView: NSTextView, completions: [String], forPartialWordRange: NSRange, indexOfSelectedItem: UnsafeMutablePointer<Int>) -> [String]
func control(NSControl, textView: NSTextView, doCommandBy: Selector) -> Bool

以上的代码方法看起来非常,但在实践开发中,大数用到的主要是下面三个:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
extension ViewController: NSTextFieldDelegate
{
/// 开始编辑
func controlTextDidBeginEditing(_ obj: Notification) {
print("controlTextDidBeginEditing")
}
/// 结束编辑
func controlTextDidEndEditing(_ obj: Notification) {
print("controlTextDidEndEditing")
}
/// 内容改变
func controlTextDidChange(_ obj: Notification) {
let textField = obj.object as? NSTextField
print("controlTextDidChange,text:" + (textField?.stringValue ?? ""))
}
}

TextField 常用属性

我们可以通过查看NSTextField.h文件,来获取到 NSTextField 的常用属性和方法有以下这些:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
// 内容为空时的提示文案
@property (nullable, copy) NSString *placeholderString;
// 内容为空时的提示文案,富文本
@property (nullable, copy) NSAttributedString *placeholderAttributedString;
// 背景色
@property (nullable, copy) NSColor *backgroundColor;
// 是否绘制背景
@property BOOL drawsBackground;
// 文字颜色
@property (nullable, copy) NSColor *textColor;
// 是否绘制边框
@property (getter=isBordered) BOOL bordered;
// 是否贝塞尔绘制
@property (getter=isBezeled) BOOL bezeled;
// 是否可编辑
@property (getter=isEditable) BOOL editable;
// 是否可选中
@property (getter=isSelectable) BOOL selectable;
// 选择文本框时调用
- (void)selectText:(nullable id)sender;
// 设置代理
@property (nullable, weak) id<NSTextFieldDelegate> delegate;
// 是否允许开始编辑文本框
- (BOOL)textShouldBeginEditing:(NSText *)textObject;
// 是否允许结束编辑文本框
- (BOOL)textShouldEndEditing:(NSText *)textObject;
// 文本框进入编辑的通知
- (void)textDidBeginEditing:(NSNotification *)notification;
- (void)textDidEndEditing:(NSNotification *)notification;
// 文本框内容发生变化的通知
- (void)textDidChange:(NSNotification *)notification;
// 获取是否接受第一响应
@property (readonly) BOOL acceptsFirstResponder;
// 设置贝塞尔风格
@property NSTextFieldBezelStyle bezelStyle;
@property CGFloat preferredMaxLayoutWidth;
// 要显示的最大行数。默认值0表示没有限制。如果文本达到了允许的行数,或者容器的高度不能容纳所需的行数,则文本将被剪切
@property NSInteger maximumNumberOfLines;

TextField文字居中

在前面内容,已经了解TextField的基本使用,但是发现使用时发现TextField中的文字没有居中显示,现在这我们来实现一个单行、文字居中的TextField

在实现单行文字居中的效果前,我们需要先了解NSTextFieldCell,它的作用是增强Cell的文本显示功能的对象。

TextFieldCell的文字默认点贴着顶部边框的,我们可以在TextFieldCell渲染的时候,通过调用内容的y坐标来调整文本的,首页我选择自定义一个承继于NSTextFieldCell的子类,因为我们希望他是单行可滚动的,所以需要设置isScrollabletrue

1
2
3
4
5
6
7
8
9
class CustomTextFieldCell: NSTextFieldCell {
override init(textCell string: String) {
super.init(textCell: string)
self.isScrollable = true
}
required init(coder: NSCoder) {
fatalError("init(coder:) has not been implemented")
}
}

接下来我们需要计算文字居中需要距离顶部的偏移量,以获取文字居中的frame:

1
2
3
4
5
6
7
8
extension CustomTextFieldCell {
private func adjustedFrameToVerticallyCenter(frame: NSRect) -> NSRect {
let ascender = font?.ascender ?? 0.0
let descender = font?.descender ?? 0.0
let offset = ceilf(Float(NSHeight(frame)/2 - ascender - descender))
return NSInsetRect(frame, 0, CGFloat(offset))
}
}

获得修正后的frame后,我在文字绘制的时候调整其frame即可达到小居中的效果:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
extension CustomTextFieldCell {
override func edit(withFrame rect: NSRect, in controlView: NSView, editor textObj: NSText, delegate: Any?, event: NSEvent?) {
let frame = adjustedFrameToVerticallyCenter(frame: rect)
super.edit(withFrame: frame, in: controlView, editor: textObj, delegate: delegate, event: event)
}

override func select(withFrame rect: NSRect, in controlView: NSView, editor textObj: NSText, delegate: Any?, start selStart: Int, length selLength: Int) {
let frame = adjustedFrameToVerticallyCenter(frame: rect)
super.select(withFrame: frame, in: controlView, editor: textObj, delegate: delegate, start: selStart, length: selLength)
}

override func drawInterior(withFrame cellFrame: NSRect, in controlView: NSView) {
let frame = adjustedFrameToVerticallyCenter(frame: cellFrame)
super.drawInterior(withFrame: frame, in: controlView)
}
}

我们实现了TextFieldCell后,在创建TextField时,把TextFieldcell指定为我们自定义的TextFieldCell,即可以实现最终的效果:

1
2
3
4
5
6
7
8
lazy var centerTextField: NSTextField = {
let v = NSTextField()
v.frame = NSRect(x: 50, y: 190, width: 100, height: 38)
let cell = CustomTextFieldCell(textCell: "CustomTextFieldCell")
cell.isEditable = true
v.cell = cell
return v
}()

快捷键支持

NSTextfield本身是不会处理系统事件的,如果在文本框中我们需要支持复制、粘贴这类事情,我们则需要单独去监听键盘事件。我们只需要重写NSResponder中的performKeyEquivalent(with:):

1
2
// 处理按键事件
func performKeyEquivalent(with event: NSEvent) -> Bool

重写该方法以处理按键事件。如果事件中的character code或codes与接收方的键值匹配,则接收方应响应事件并返回true。如果不重写,该方法默认返回false,什么也不做。

了解performKeyEquivalent(with:)的作用后,我们只要重写该方法并通过按键值来做相应的处理,却可以实现相应的快捷功能:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
extension NSTextField {
override open func performKeyEquivalent(with event: NSEvent) -> Bool {
let modifierkeys = event.modifierFlags.intersection(.deviceIndependentFlagsMask)
let key = event.characters ?? ""
/// 点击 esc 取消焦点
if modifierkeys.rawValue == 0 && key == "\u{1B}" {
self.window?.makeFirstResponder(nil)
}
// command + shift + z 还原
if modifierkeys == [.command, .shift] && key == "z" {
self.window?.firstResponder?.undoManager?.redo()
return true
}
if modifierkeys != .command {
return super.performKeyEquivalent(with: event)
}
switch key {
case "a": // 撤消
return NSApp.sendAction(#selector(NSText.selectAll(_:)), to: self.window?.firstResponder, from: self)
case "c": // 复制
return NSApp.sendAction(#selector(NSText.copy(_:)), to: self.window?.firstResponder, from: self)
case "v": // 粘贴
return NSApp.sendAction(#selector(NSText.paste(_:)), to: self.window?.firstResponder, from: self)
case "x": // 剪切
return NSApp.sendAction(#selector(NSText.cut(_:)), to: self.window?.firstResponder, from: self)
case "z": // 撤消
self.window?.firstResponder?.undoManager?.undo()
return true
default:
return super.performKeyEquivalent(with: event)
}
}
}

源代码

源代码