TextFragment

TextFragment class

表示 Pdf 文本的片段。

public class TextFragment : BaseParagraph

构造函数

姓名描述
TextFragment()初始化TextFragment对象.
TextFragment(string)创建TextFragment对象单TextSegment里面的对象。 指定段内的文本字符串。
TextFragment(TabStops)初始化TextFragment具有预定义的对象TabStops位置.
TextFragment(string, TabStops)创建TextFragment对象单TextSegment内部和预定义的对象TabStops位置.

特性

姓名描述
BaselinePosition { get; set; }获取文本的文本位置，用TextFragmentobject. Position 结构的 YIndent 表示文本片段的基线坐标。
EndNote { get; set; }获取或设置段落尾注。（仅用于 pdf 生成）
FootNote { get; set; }获取或设置段落脚注。（仅用于 pdf 生成）
Form { get; }获取包含 TextFragment 的表单对象
override HorizontalAlignment { get; set; }获取或设置文本片段的水平对齐方式。
override Hyperlink { set; }设置片段超链接
IsFirstParagraphInColumn { get; set; }获取或设置一个布尔值，指示此段落是否将在下一列。 默认为 false。（用于 pdf 生成）
IsInLineParagraph { get; set; }获取或设置段落是内联的。 默认为 false。（用于 pdf 生成）
IsInNewPage { get; set; }获取或设置一个 bool 值，强制此段落在新页面生成。 默认为 false。（用于 pdf 生成）
IsKeptWithNext { get; set; }获取或设置一个布尔值，指示当前段落是否与下一个段落保持在同一页面中。 默认为 false。（用于 pdf 生成）
Margin { get; set; }获取或设置段落的外边距（用于生成 pdf）
Page { get; }获取包含 TextFragment 的页面
Position { get; set; }获取或设置文本的文本位置，用TextFragment对象.
Rectangle { get; }获取 TextFragment 的矩形
ReplaceOptions { get; }获取文本替换选项。选项定义片段文本替换为更短/更长时的行为。
Segments { get; set; }获取当前文本段TextFragment.
Text { get; set; }获取或设置String文本对象TextFragment对象代表.
TextState { get; }获取或设置文本的文本状态TextFragment对象代表.
override VerticalAlignment { get; set; }获取或设置文本片段的垂直对齐方式。
WrapLinesCount { get; set; }获取或设置此段落的换行数（仅用于 pdf 生成）
ZIndex { get; set; }获取或设置一个 int 值，指示图形的 Z 顺序。 ZIndex 较大的图将放置在 ZIndex 较小的图上。 ZIndex 可以是负数。带有负数 ZIndex 的图形将被放置在页面中的文本后面。

方法

姓名描述
override Clone()克隆片段。
virtual CloneWithSegments()克隆所有片段的片段。
IsolateTextSegments(int, int)获取TextSegment(s) 代表指定部分TextFragment文本.

评论

简而言之，TextFragment对象包含列表TextSegmentobjects. 详细信息： pdf 文档中的文本Pdf由两个基本对象表示：TextFragment和TextSegment 它们之间的差异主要取决于上下文。 让我们考虑以下场景。用户搜索文本“hello world”以对其进行操作，更改其属性，查看等。 物理上pdf文本的表示非常复杂。 文本“hello world”可能由几个物理上独立的文本段组成。 Aspose.Pdf文本模型基本上建立了TextFragmentobject 在物理上提供单一逻辑操作集TextSegment代表用户查询的对象集。 在文本搜索场景中，TextFragment是逻辑“hello world”文本表示， 和TextSegment对象集合表示构造“hello world”文本对象的所有物理段。 所以，TextFragment接近逻辑文本表示。 和TextSegment接近物理文本表示。 显然每个TextSegment对象可能有它自己的字体、颜色、定位属性。 TextFragment提供简单的方法来更改文本的属性：设置字体、设置字体大小、设置字体颜色等。 同时TextSegment对象是可访问的，用户可以使用TextSegment对象独立。 请注意，更改 TextFragment 属性可能会更改内部Segments集合，因为 TextFragment 是一个聚合对象 并且它可能会重新排列内部段或将它们合并为单个段。 如果您的要求是离开Segments集合不变，请单独更改内部段。

Document doc = new Document(docFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");
doc.Pages[1].Accept(absorber);

例子

该示例演示如何在第一个 PDF 文档页面上查找文本并替换文本及其字体。

// 打开文档
Document doc = new Document(@"D:\Tests\input.pdf");

// 查找将用于更改文档文本字体的字体
Aspose.Pdf.Txt.Font font = FontRepository.FindFont("Arial");

// 创建 TextFragmentAbsorber 对象以查找所有“hello world”文本出现
TextFragmentAbsorber absorber = new TextFragmentAbsorber("hello world");

// 接受第一页的吸收器
doc.Pages[1].Accept(absorber);

// 更改第一个文本出现的文本和字体
absorber.TextFragments[1].Text = "hi world";
absorber.TextFragments[1].TextState.Font = font;

// 保存文档
doc.Save(@"D:\Tests\output.pdf");

也可以看看

TextFormattingOptions.WordWrapMode TextFragmentAbsorber