Mac开发-NSTextView软回车转换为硬回车

最新推荐文章于 2024-08-26 09:11:49 发布

原创最新推荐文章于 2024-08-26 09:11:49 发布 · 749 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Mac #NSTextView #软回车 #硬回车

Mac开发专栏收录该内容

34 篇文章

订阅专栏

本文探讨了在NSTextView中如何将软回车转换为硬回车的解决方案，利用TextKit框架中的NSLayoutManager和enumerateLineFragmentsForGlyphRange方法，详细介绍了实现过程并提供了demo供参考。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

背景说明

软回车和硬回车:在字处理软件中，由Enter键按下去导致一行文字换行的叫硬回车，程序自动换行的叫做软回车。

当NSTextView的宽度被限制时，会自动换行，这里就是添加了软回车，当我们手动键入Enter，则是在字符串中插入了\n换行符，数据内容已经改变。软回车不会改变数据内容，即不会插入\n

需求为当NSTextView进行软回车时，记录下来，在某个时机发出其内容，并将软回车转换为硬回车，即在对应位置插入\n

TextKit

NSTextView的基础使用参考 https://blog.youkuaiyun.com/lovechris00/article/details/78014081

TextKit 框架主要的成员对象（典型的MVC）：

NSTextStorage 是 NSMutableAttributedString 的子类，负责存储需要处理的文本及其属性。
NSLayoutManager 负责将 NSTextStorage 中的文本数据渲染到显示区域上，负责字符的编码和布局。
NSTextContainer 描述了一个显示区域，默认是矩形，其子类可以定义任意的形状。它不仅定义了可填充的区域，而且内部还定义了一个不可填充区域（Bezier Path 数组）。

参考这篇文章 https://www.jianshu.com/p/a12ecae89d6b 和官方文档中搜索。

即NSTextStorage负责文本内容，NSLayoutManager负责布局换行，字符处理，NSTextContainer负责显示的区域。
在我们使用NSTextView时，默认都会关联上述3个。监听软回车则需要监听到换行，或者每行所占字符数，即着重点在NSLayoutManager中。

解决方案

最初

layoutManager:shouldBreakLineByWordBeforeCharacterAtIndex方法是NSLayoutManager的代理方法，在文本改变时，会抛出软回车位置。

起初我想用这个回调，但发现layoutManager:shouldBreakLineByWordBeforeCharacterAtIndex在文本内容全是英文时，返回的软回车位置不对。
例如：

本应该软回车位置为 11 22 33 时
当中文时，返回为 11 22 33
当英文时，返回为 0  11 22 会缺少最后一位

这个回调当文本改变时就会回调。

最终方案

我又找到了一个可以计算出每行的字符长度的方法
即NSLayoutManager中的 enumerateLineFragmentsForGlyphRange

// Enumerates line fragments intersecting with glyphRange.
- (void)enumerateLineFragmentsForGlyphRange:(NSRange)glyphRange usingBlock:(void (^)(NSRect rect, NSRect usedRect, NSTextContainer *textContainer, NSRange glyphRange, BOOL *stop))block NS_AVAILABLE(10_11, 7_0);

这个方法需要主动调用，会在block块中返回每行的字符串范围。

参数说明如下

rect 预留给该行使用的大小
usedRect 实际该行使用的大小
textContainer 自己的textContainer实例
glyphRange 文本Range,由Postion和length组成。表示该行开始位置，以及长度

那我们就很好处理了，分别记录，然后从后向前插入\n即可

__weak typeof(self) wself = self;
    [_layoutManagerB enumerateLineFragmentsForGlyphRange:NSMakeRange(0, testString.length) usingBlock:^(NSRect rect, NSRect usedRect, NSTextContainer * _Nonnull textContainer, NSRange glyphRange, BOOL * _Nonnull stop) {
        __strong typeof(self) sself = wself;
        NSInteger index = glyphRange.location + glyphRange.length;
        [sself.breaklineIndexs addObject:@(index)];
        if (sself.layoutManagerB.numberOfGlyphs == index) { //因为最后一个字符后一定会插入\n，当字符数量==index时,即stop
            NSString *result = [self getBreaklineString];
            NSLog(@"添加硬回车后的字符串为 %@",result);
            *stop = YES;
        }
    }];