FreeTextAnnotation

概述

FreeTextAnnotation 是 Aspose.PDF FOSS 中用于 .NET 的类。继承自：MarkupAnnotation。

此类提供 19 个方法，用于在 .NET 程序中操作 FreeTextAnnotation 对象。可用的方法包括：Accept、ChangeAfterResize、ClearState、Clone、FindStateAnnotation、Flatten、FreeTextAnnotation、GetRectangle、GetState、GetStateModel、MarkupAnnotation、SetMarkedState，以及另外 4 个方法。所有公共成员在安装 Aspose.PDF FOSS for .NET 包后，可供任何 .NET 应用程序访问。属性：Action、Actions、ActiveState、Alignment、AnnotationFlags、AnnotationState，以及另外 55 项。

属性

名称	类型	访问	描述
`DefaultAppearance`	`string?`	读写	该 /DA 默认外观字符串。
`DefaultAppearanceObject`	`DefaultAppearance`	读取	支撑 DefaultAppearance 的强类型默认外观对象。
`DefaultStyle`	`string?`	读写	内联默认富文本样式在 /DS 中携带。
`RichText`	`string?`	读写	用于注释（/RC 条目）的富文本字符串（XHTML）。
`AnnotationType`	`AnnotationType`	读取	始终 FreeText。
`Callout`	`Point[]?`	读写	标注折线 (/CL 条目，PDF 32000 §12.5.6.6 — 自由文本)。
`Justification`	`Justification`	读写	已渲染文本的对齐方式 (/Q: 0=左, 1=居中, 2=右)。
`Intent`	`FreeTextIntent`	读写	自由文本意图 (/IT — FreeTextCallout / FreeTextTypeWriter)。
`StartingStyle`	`LineEnding`	读写	起始换行样式 (/LE 第一个条目；仅用于标注意图)。
`EndingStyle`	`LineEnding`	读写	结束换行样式 (/LE 第二个条目；仅用于标注意图)。
`Rotate`	`Aspose.Pdf.Rotation`	读写	已渲染文本的页面旋转 (/Rotate)。
`TextRectangle`	`Rectangle?`	读写	内部文本矩形 (/RD 相对于 /Rect 的内缩)。
`TextStyle`	`TextStyle`	读写	在渲染富文本内容时应用的捆绑文本样式（字体 / 大小 / 颜色 / 对齐）。
`CreationDate`	`System.DateTime`	读写	创建时间戳记录在 /CreationDate。
`Opacity`	`double`	读写	不透明度 (0..1) 存储在 /CA。
`Popup`	`PopupAnnotation?`	读写	关联的弹出注释 (/Popup)。
`ReplyType`	`ReplyType`	读写	对 InReplyTo 的回复关系 (/RT)。
`Subject`	`string?`	读写	主题行 (/Subj)。
`Title`	`string?`	读写	作者 / 标题携带在 /T。
`Rect`	`Rectangle?`	读写	注释矩形（页面上的位置）。
`InnerRect`	`Rectangle?`	读取	注释矩形通过 /RD（矩形差异）条目内缩——即实际在 Rect 内绘制的区域。
`Width`	`double`	读写	注释矩形的宽度。
`Height`	`double`	读写	注释矩形的高度。
`ActiveState`	`string?`	读写	当前活动的外观状态（/AS 条目）。
`Alignment`	`TextAlignment`	读写	文本对齐（用于携带富文本的自由文本/小部件注释）。
`HorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	读写	水平对齐（在 Alignment 之外另行提供；两者可独立设置）。
`TextHorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	读写	文本特定的水平对齐覆盖。
`Appearance`	`AppearanceDictionary`	读取	外观字典（/AP 条目）——以外观流名称（N、D、R）为键。
`States`	`AppearanceDictionary`	读取	外观状态字典（AP/N 的每个状态的子字典，例如）.
`NormalAppearance`	`XForm?`	读取	注释的普通 (/AP /N) 外观为 XForm，如果没有则为 null。
`UpdateAppearanceOnConvert`	`bool`	读写	在将注释保存到已转换的文档时，是否重新生成外观流。
`UseFontSubset`	`bool`	读写	是否应对嵌入的字体（如果有）进行子集化。
`Contents`	`string?`	读写	注释内容（文本）。
`Border`	`Border?`	读写	注释边框。
`Color`	`Color`	读写	注释的边框颜色（/C 条目）。
`InteriorColor`	`Color?`	读写	注释的内部颜色（/IC 条目，适用于圆形/方形/线条注释）。
`Name`	`string?`	读写	注释名称（唯一标识符 — /NM 条目）。
`FullName`	`string?`	读取	完全限定的注释名称。
`ModifiedDate`	`string?`	读取	修改日期。
`Modified`	`DateTime`	读写	/M（modified）日期以已键入的 DateTime 形式呈现。
`Flags`	`AnnotationFlags`	读写	注释标志 (/F entry) — 用作 int 和已键入形式的存储后端。
`AnnotationFlags`	`AnnotationFlags`	读写	Flags 的类型别名，匹配公共接口并将 AnnotationFlags 公开为属性。
`Action`	`PdfAction?`	读写	与此注释关联的操作（/A 条目）。
`Actions`	`PdfActionCollection`	读取	与此注释关联的操作集合。
`Author`	`string?`	读取	注释作者 (/T 条目)。
`AnnotationState`	`string?`	读取	注释状态 (/State 条目)，例如。
`AnnotationStateModel`	`string?`	读取	注释状态模型 (/StateModel 条目)，例如。
`InReplyTo`	`Annotation?`	读写	此注释正在回复的注释（/IRT entry）。
`QuadPoints`	`Point[]`	读写	QuadPoints 作为 Point 值的数组。
`Characteristics`	`Characteristics`	读取	外观特征（边框颜色、背景颜色、旋转）。
`PageIndex`	`int`	读取	拥有此注释的页面的基于1的索引。
`Page`	`Page?`	读取	拥有此注释的页面，若无法解析则为 null（例如.
`VerticalAlignment`	`VerticalAlignment`	读写	已对该段落应用垂直对齐。
`Margin`	`MarginInfo`	读写	已对该段落应用外边距信息。
`IsFirstParagraphInColumn`	`bool`	读写	强制段落在新列开始。
`IsKeptWithNext`	`bool`	读写	保持此段落与下一段在同一页。
`IsInNewPage`	`bool`	读写	强制段落在新页开始。
`IsInLineParagraph`	`bool`	读写	行内段落标志（不另起新行）。
`HyperlinkText`	`string?`	读写	旧版字符串类型的超链接目标。
`Hyperlink`	`Hyperlink?`	读写	已类型化的超链接装饰已应用于段落。
`ZIndex`	`int`	读写	DOM 渲染器使用的 Z-order 索引。

方法

签名	描述
`FreeTextAnnotation(page: Page, rect: Rectangle, appearance: DefaultAppearance)`	创建一个具有默认外观的 FreeTextAnnotation。
`FreeTextAnnotation(document: Document, appearance: DefaultAppearance)`	文档绑定的构造函数用于创建尚未附加到特定页面的 FreeTextAnnotation；调用者通过 page.Annotations.Add(annot) 将其添加。
`SetTextStyle(textStyles: RichTextFontStyles, fontName: string, fontSize: double, fontColor: System.Drawing.Color)`	将样式标志应用于整个文本运行。
`SetTextStyle(fromInd: int, toInd: int, textStyles: RichTextFontStyles)`	将富文本样式标志应用于子字符串 [fromInd, toInd)。
`Accept(visitor: AnnotationSelector)`	在此 FreeTextAnnotation 实例上调用 Accept(visitor)。
`MarkupAnnotation(document: Document)`	文档绑定的构造函数，用于创建尚未附加到特定页面的标记注释；调用者随后通过 page.Annotations.Add(annot) 将其添加。
`GetState()`	读取注释属性字典中的 /State 条目。
`GetStateModel()`	读取 /StateModel 条目，将缺失的 /entry 映射为 Undefined。
`SetMarkedState(marked: bool)`	将 `/State` 设置为 `Marked` 或 `Unmarked`，并将 `/StateModel` = `Marked`。
`SetReviewState(state: AnnotationState)`	设置审阅状态。
`SetReviewState(state: AnnotationState, userName: string)`	设置审阅状态以及审阅者的用户名（根据 PDF 规范记录在 /T 中）。
`ClearState()`	删除所有已记录的 /State 和 /StateModel。
`FindStateAnnotation()`	查找与此标记关联的状态跟踪注释（根据 PDF 32000 §12.5.6.3，携带 /State 条目的最近的 /IRT 回复注释）。
`GetRectangle(considerRotation: bool)`	通过 considerRotation 调整的边界矩形。
`ChangeAfterResize(transform: Matrix)`	在用户调整页面或宿主矩形大小后，调整注释的几何形状。
`UpdateAppearances()`	从注释的当前几何形状和颜色重新生成普通外观流 (/AP /N)。
`WriteXfdf(writer: System.Xml.XmlWriter)`	将此注释序列化为 XFDF 元素写入 writer (PDF 32000 §12.7.8 / XFDF 3.0)。
`Flatten()`	扁平化此注释 — 将其视觉外观渲染到页面内容中，并从页面的注释数组中移除。
`Clone()`	浅拷贝 — 复制标量/引用共享状态。

另请参阅

Aspose.PDF for .NET — Enterprise API Reference