如何让iText7中SetMultiline(true)实现文本自动换行？

在Mac系统的.NET 7.0.0应用中使用iText7 7.2.4创建多行文本域时，设置SetMultiline(true)后文本无法自动换行，仅当设置背景色时才会触发换行效果。不想依赖背景色方案，且找不到设置背景色透明度的方法。

方案1：强制生成表单域外观 #

Preview对未显式生成外观的多行文本域存在渲染bug，通过强制生成字段外观可以解决换行问题。在添加所有表单域后调用GenerateAppearances()方法：

// 添加完所有字段后执行
form.GenerateAppearances();

也可以针对单个字段单独生成外观：

nonWrapping.GenerateAppearance();

该操作会让iText7为字段生成符合PDF规范的可视化外观，确保Preview能正确识别多行文本的换行逻辑。

方案2：设置完全透明的背景色 #

如果希望借助背景色触发Preview的换行逻辑，但不想显示可见背景，可以设置完全透明的背景色。使用TransparentColor类实现：

nonWrapping.SetMultiline(true);
// 设置完全透明的背景色，视觉上无任何显示
nonWrapping.SetBackgroundColor(new TransparentColor(DeviceRgb.WHITE, 0f));
form.AddField(nonWrapping);

透明背景色不会在PDF中呈现，但会触发Preview的换行渲染逻辑，同时避开了可见背景的问题。

问题原因 #

这是Mac Preview的特定渲染问题，并非iText7生成的PDF不符合规范。当多行文本域没有背景色或显式生成的外观时，Preview未正确触发文本换行的布局计算；而设置背景色或强制生成外观会让Preview正确处理换行逻辑。

内容的提问来源于stack exchange，提问作者John Hurrell