WidgetAnnotation

概述

WidgetAnnotation 是 Aspose.PDF FOSS 中用于 .NET 的一个类。继承自：Annotation。

此类提供 13 个方法，用于在 .NET 程序中处理 WidgetAnnotation 对象。可用的方法包括：Accept、ChangeAfterResize、Clone、ExportToJson、Flatten、GetCheckedStateName、GetRectangle、UpdateAppearances、WidgetAnnotation、WriteXfdf。安装 Aspose.PDF FOSS for .NET 包后，所有公共成员对任何 .NET 应用程序均可访问。属性：Action、Actions、ActiveState、Alignment、AnnotationFlags、AnnotationState，以及另外 53 项。

属性

名称	类型	访问	描述
`AnnotationType`	`AnnotationType`	读取	始终小部件。
`Border`	`Border?`	读写	边框宽度、样式和虚线模式从小部件的 BS 字典中解析（表单字段的边框信息存放在那里，而不是在 /Border 中）。
`Actions`	`AnnotationActionCollection`	读取	小部件的 /AA 树的操作槽。
`DefaultAppearance`	`DefaultAppearance`	读写	此小部件的默认外观（字体、大小、颜色）。
`Exportable`	`bool`	读写	是否在表单提交时导出小部件的值。
`Highlighting`	`HighlightingMode`	读写	用户点击小部件时使用的可视高亮模式（/H 条目）。
`OnActivated`	`PdfAction?`	读写	小部件被激活时调用的操作（/A 条目）。
`Parent`	`Forms.Field?`	读取	当此小部件是 AcroForm 字段的可视子项时的父字段。
`ReadOnly`	`bool`	读写	小部件是否拒绝输入（/Ff 位 1）。
`Required`	`bool`	读写	小部件在提交前是否必须填写（/Ff 位 2）。
`HighlightMode`	`string`	读取	高亮模式（/H 条目）。
`DefaultAppearanceString`	`string?`	读取	默认外观字符串（/DA 条目）。
`NormalAppearance`	`XForm?`	读取	小部件的 “Normal” 外观（/AP /N 流）。
`FieldValue`	`string?`	读取	字段值（/V 条目）。
`DefaultFieldValue`	`string?`	读取	默认字段值（/DV 条目）。
`FieldType`	`string?`	读取	字段类型（/FT 条目）。
`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 的每个状态子字典，例如.
`UpdateAppearanceOnConvert`	`bool`	读写	当注释保存到已转换的文档时，是否重新生成外观流。
`UseFontSubset`	`bool`	读写	是否应对嵌入的字体（如果有）进行子集化。
`Contents`	`string?`	读写	注释内容（文本）。
`Opacity`	`double`	读写	注释不透明度（0.0 = 透明，1.0 = 不透明）。
`Color`	`Color`	读写	注释边框颜色（/C 条目）。
`InteriorColor`	`Color?`	读写	注释的内部颜色（/IC 条目，适用于圆形/方形/线条注释）。
`Title`	`string?`	读写	注释标题（标记注释的作者）。
`Name`	`string?`	读写	注释名称（唯一标识符 — /NM 条目）。
`FullName`	`string?`	读取	完全限定的注解名称。
`Subject`	`string?`	读写	注解主题（/Subj 条目）。
`ModifiedDate`	`string?`	读取	修改日期。
`Modified`	`DateTime`	读写	将 /M（已修改）日期作为已键入的 DateTime。
`Flags`	`AnnotationFlags`	读写	注释标志（/F 条目）——用于整数和已键入形式的存储后端。
`AnnotationFlags`	`AnnotationFlags`	读写	Flags 的类型别名，匹配公开表面并将 AnnotationFlags 公开为属性。
`Action`	`PdfAction?`	读写	与此注释关联的操作（/A 条目）。
`Author`	`string?`	读取	注释作者（/T 条目）。
`AnnotationState`	`string?`	读取	注释状态（/State 条目），例如。
`AnnotationStateModel`	`string?`	读取	注释状态模型 (/StateModel 条目)，例如。
`ReplyType`	`string?`	读取	回复类型（/RT entry），例如：
`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 索引。

方法

签名	描述
`WidgetAnnotation(doc: Document)`	编程 ctor — 创建一个与文档阅读器关联的裸部件注释。
`ExportToJson(stream: System.IO.Stream)`	将此小部件的字段序列化为 JSON 到流中。
`ExportToJson(fileName: string)`	将此小部件的字段序列化为 JSON 到文件中。
`ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?)`	将此小部件的字段序列化为单个 FieldExportingData JSON 对象到流中。
`ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?)`	将此小部件的字段序列化为 JSON 到文件中。
`GetCheckedStateName()`	返回表示此小部件 “on” / “checked” 状态的外观状态名称（通常为 “Yes”），从 /AP/N 字典的键中查找（任何不是 “Off” 的键）。
`Accept(visitor: AnnotationSelector)`	对该 WidgetAnnotation 实例调用 Accept(visitor)。
`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()`	扁平化此注释——将其视觉外观渲染到页面内容中，并从页面的 annotations 数组中移除。
`Clone()`	浅克隆——复制标量/引用共享的状态。

另请参阅

Aspose.PDF for .NET — Enterprise API Reference