|
Foxit PDF SDK
|
Public 成员函数 | |
| Annot (PDFPage page, PDFDictionary annot_dict) | |
| 构造函数,使用PDF页面和注释的PDF字典。 更多... | |
| Annot (Annot annot) | |
| 构造函数,使用另一个注释对象。 更多... | |
| Annot () | |
| 构造函数。 | |
| PDFStream | GetAppearanceStream (Annot.AppearanceType type, string appearance_state) |
| 获取具有指定类型和状态的注释外观流。 更多... | |
| int | GetBorderColor () |
| 获取边框颜色。 更多... | |
| BorderInfo | GetBorderInfo () |
| 获取边框信息。 更多... | |
| string | GetContent () |
| 获取内容。 更多... | |
| RectI | GetDeviceRect (Matrix2D matrix) |
| 获取设备坐标系统中的注释矩形。 更多... | |
| PDFDictionary | GetDict () |
| 获取注释的字典对象。 更多... | |
| Matrix2D | GetDisplayMatrix (Matrix2D page_display_matrix) |
| 获取显示矩阵,从到 目标设备坐标系统。 更多... | |
| int | GetFlags () |
| 获取注释标志。 更多... | |
| int | GetIndex () |
| 获取当前注释在其所属页面中的索引。 更多... | |
| DateTime | GetModifiedDateTime () |
| 获取最后修改日期时间。 更多... | |
| PDFDictionary | GetOptionalContent () |
| 获取注释可选内容的PDF字典。 更多... | |
| PDFPage | GetPage () |
| 获取相关的PDF页面。 更多... | |
| RectF | GetRect () |
| 获取矩形,以表示。 更多... | |
| Annot.Type | GetType () |
| 获取当前注释的实际注释类型。 更多... | |
| string | GetUniqueID () |
| 获取唯一ID。 更多... | |
| bool | HasProperty (Annot.Property property) |
| 当前注释是否具有指定的注释属性。 更多... | |
| bool | IsEmpty () |
| 检查当前对象是否为空。 更多... | |
| bool | IsMarkup () |
| 检查当前注释是否为标记注释。 更多... | |
| bool | Move (RectF rect) |
| 将当前注释移动到新位置,由中的新矩形指定。 更多... | |
| bool | Move (RectF rect, bool is_reset_appearance) |
| 将当前注释移动到新位置,由中的新矩形指定。 更多... | |
| bool | RemoveProperty (Annot.Property property) |
| 删除指定的注释属性。 更多... | |
| bool | ResetAppearanceStream () |
| 重置外观流。 更多... | |
| bool | ResetAppearanceStream (bool is_generate_new_appearance_obj) |
| 重置外观流。 更多... | |
| void | SetBorderColor (int color) |
| 设置边框颜色。 更多... | |
| void | SetBorderInfo (BorderInfo border) |
| 设置边框信息。 更多... | |
| void | SetContent (string content) |
| 设置内容。 更多... | |
| void | SetFlags (int flags) |
| 设置注释标志。 更多... | |
| void | SetModifiedDateTime (DateTime date_time) |
| 设置最后修改日期时间。 更多... | |
| void | SetUniqueID (string unique_id) |
| 设置唯一ID。 更多... | |
注释将对象(如注记、声音或电影)与PDF文档页面上的位置关联起来, 或提供通过鼠标和键盘与用户交互的方式。PDF包含各种各样的 标准注释类型。
类Annot 是所有PDF注释类型的基类。它提供获取/设置 注释公共属性、移动注释或重置注释外观流的基础函数。 对于具体的注释类型,请参考派生类。要获取注释计数或 获取/添加/移除注释,请参考类pdfPDFPage。
此类对象也可用于构造其他类的对象,以便在注释中进行更多操作 或访问注释的指定信息:
要访问附加动作,请使用注释对象构造foxit.pdf.actions.AdditionalAction 对象。 只有少数类型的注释可能有附加动作。有关更多详细信息,请参考 类foxit.pdf.actions.AdditionalAction 。
要在注释中搜索文本,请使用注释对象构造foxit.pdf.TextSearch 对象。 搜索只能支持某些类型的注释。有关更多详细信息,请参考 类foxit.pdf.TextSearch 。
类Annot 中的所有"set"函数。
函数Annot.Move 、Annot.ResetAppearanceStream 、 Annot.RemoveProperty 。
|
strong |
|
strong |
PDF注释标志的枚举。
此枚举的值可以单独使用或组合使用。
| 枚举值 | |
|---|---|
| e_FlagInvisible | 注释标志:不可见。 如果设置,当注释不属于标准注释类型且没有可用的注释处理程序时,不显示该注释。 如果清除,则使用其外观字典指定的外观流显示此类非标准注释(如果有)。 |
| e_FlagHidden | 注释标志:隐藏。 如果设置,不显示或打印注释或允许用户与其交互, 无论其注释类型如何或是否有可用的注释处理程序。 |
| e_FlagPrint | 注释标志:打印。 如果设置,打印页面时打印注释。如果清除,从不打印注释, 无论它是否显示在屏幕上。这可能很有用,例如, 对于表示交互式按钮的注释,这些按钮在打印页面上没有意义。 |
| e_FlagNoZoom | 注释标志:无缩放。 如果设置,不根据页面的放大倍数缩放注释的外观。 注释在页面上的位置(由其注释矩形的左上角定义) 保持固定,无论页面放大倍数如何。 |
| e_FlagNoRotate | 注释标志:无旋转。 如果设置,不根据页面的旋转旋转注释的外观。 注释矩形的左上角在页面上保持固定位置, 无论页面旋转如何。 |
| e_FlagNoView | 注释标志:无视图。 如果设置,不在屏幕上显示注释或允许用户与其交互。 注释可能被打印(取决于标志foxit.pdf.annots.Annot.Flags.e_FlagPrint 的设置), 但在屏幕显示和用户交互方面应被视为隐藏。 |
| e_FlagReadOnly | 注释标志:只读。 如果设置,不允许注释与用户交互。注释可能显示或打印 (取决于标志foxit.pdf.annots.Annot.Flags.e_FlagNoView 和foxit.pdf.annots.Annot.Flags.e_FlagPrint 的设置), 但不应响应鼠标点击或响应鼠标移动而改变其外观。
|
| e_FlagLocked | 注释标志:锁定。 如果设置,不允许用户删除注释或修改其属性(包括位置和大小)。 但是,此标志不限制对注释内容的更改,例如表单字段的值。 |
| e_FlagToggleNoView | 注释标志:切换无视图。 如果设置,为某些事件反转NoView标志的解释。一个典型用途是 使注释仅在鼠标光标悬停在其上时出现。 |
| e_FlagLockedContents | 注释标志:锁定内容。 如果设置,不允许用户修改注释的内容。 此标志不限制删除注释或更改其他注释属性,例如位置和大小。 |
|
strong |
|
strong |
注释MK字典(外观特征)条目的枚举。
此枚举的值应单独使用。
|
strong |
|
strong |
|
strong |
PDF注释类型的枚举。
此枚举的值应单独使用。
|
inline |
构造函数,使用PDF页面和注释的PDF字典。
| [in] | page | 有效的PDF页面。 |
| [in] | annot_dict | 注释的PDF字典。它应该表示一个注释,并且应该在 参数page指定的PDF页面中。 |
|
inline |
构造函数,使用另一个注释对象。
| [in] | annot | 另一个注释对象。 |
|
inline |
获取具有指定类型和状态的注释外观流。
有关更多详细信息,请参考 <PDF参考1.7> 中 "表8.15 所有注释字典通用条目"中的"AP"和"AS"条目。
| [in] | type | 注释外观类型。请参考 foxit.pdf.annots.Annot.AppearanceType.e_AppearanceTypeNormal 及相关值。 |
| [in] | appearance_state | 注释的外观状态,用于从外观子字典中选择适用的外观流。 如果为空字符串,Foxit PDF SDK 将选择注释字典中"AS"(外观状态)条目指定的外观状态。 |
|
inline |
获取边框颜色。
此属性对注释的外观有影响。
|
inline |
获取边框信息。
此属性对注释的外观有影响。对于没有边框信息的注释,将返回默认边框信息:
边框宽度 = 1,边框样式 = foxit.pdf.annots.BorderInfo.Style.e_Solid , 边框云状强度 = 0,边框虚线相位 = 0,边框虚线数组为空数组。 注意:在支持的注释类型中(请参考类 Annot 的"注意"注释部分), 此属性对以下注释的外观不起作用: 注记、高亮、下划线、删除线、波浪线、印章、插入符、弹出窗口、文件附件、PSInk、编辑。 对于墨迹注释,只有边框宽度对墨迹注释的外观有影响。
|
inline |
获取内容。
获取设备坐标系统中的注释矩形。
这是获取注释的设备矩形的有用函数, 但不支持弹出注释。
对于矩形转换,结果矩形始终是"标准化的",即 使用设备坐标系统:左侧始终小于右侧,顶部始终小于底部。
| [in] | matrix | 用于从转换到 设备坐标系统的矩阵。通常,这由函数 pdf.PDFPage.GetDisplayMatrix 返回,也用于渲染。 |
|
inline |
获取注释的字典对象。
获取显示矩阵,从到 目标设备坐标系统。
当前注释的显示矩阵可以与注释的矩形一起使用, 以计算注释在目标设备坐标系统中的实际区域。
| [in] | page_display_matrix | The transformation matrix. Usually this is returned by function PDFPage.GetDisplayMatrix . |
|
inline |
获取注释标志。
|
inline |
获取当前注释在其所属页面中的索引。
|
inline |
获取最后修改日期时间。
|
inline |
获取注释可选内容的PDF字典。
|
inline |
获取相关的PDF页面。
|
inline |
获取矩形,以表示。
|
inline |
获取当前注释的实际注释类型。
|
inline |
获取唯一ID。
|
inline |
当前注释是否具有指定的注释属性。
| [in] | property | 属性名称。请参考从foxit.pdf.annots.Annot.Property.e_PropertyModifiedDate 开始的值, 这应该是这些值中的一个。 |
|
inline |
检查当前对象是否为空。
当当前对象为空时,这意味着当前对象是无用的。
|
inline |
检查当前注释是否为标记注释。
|
inline |
将当前注释移动到新位置,由中的新矩形指定。
| [in] | rect | 指定当前注释要移动到的新位置的新矩形。 它应该在中有效。 |
|
inline |
将当前注释移动到新位置,由中的新矩形指定。
| [in] | rect | 指定当前注释要移动到的新位置的新矩形。 它应该在中有效。 |
| [in] | is_reset_appearance | 布尔值,指定移动后是否重置注释的外观。 |
|
inline |
删除指定的注释属性。
此函数可用于删除注释的某些可选属性。 当成功删除与外观相关的属性时,例如 foxit.pdf.annots.Annot.Property.e_PropertyBorderColor 和 foxit.pdf.annots.Annot.Property.e_PropertyFillColor , 用户应调用函数 Annot.ResetAppearanceStream 以在注释外观上产生效果。
| [in] | property | 属性名称。请参考从 foxit.pdf.annots.Annot.Property.e_PropertyModifiedDate 开始的值, 应为这些值中的一个。 |
|
inline |
重置外观流。
注释的外观作为流存储在PDF文档中。 任何与外观相关的属性都可以通过相应的设置函数进行更改。 为了使此更改生效,应调用此函数来更新注释的外观。
请查看类 Annot 注释中的"注意"部分,了解哪些类型的注释可以 通过当前函数重置外观,并检查这些注释类的注释,以了解在重置外观流之前是否需要任何属性。
|
inline |
重置外观流。
注释的外观作为流存储在PDF文档中。 任何与外观相关的属性都可以通过相应的设置函数进行更改。 为了使此更改生效,应调用此函数来更新注释的外观。
请查看类 Annot 注释中的"注意"部分,了解哪些类型的注释可以 通过当前函数重置外观,并检查这些注释类的注释,以了解在重置外观流之前是否需要任何属性。
| [in] | is_generate_new_appearance_obj | true 表示生成新的外观对象来重置当前注释的外观, false 表示重置共享此外观流的注释的外观。 该参数仅对小组件注释的外观有影响。 |
|
inline |
设置边框颜色。
此属性对注释的外观有影响。如果用户希望新的边框颜色对 注释的外观有影响,请在设置新边框颜色后调用函数Annot.ResetAppearanceStream 。
| [in] | color | 要设置的新边框颜色。格式:0xRRGGBB。 |
|
inline |
设置边框信息。
此属性对注释的外观有影响。如果用户希望新的边框信息对注释的外观有影响, 请在设置新边框信息后调用函数 Annot.ResetAppearanceStream 。
注意:在支持的注释类型中(请参考类 Annot 的"注意"注释部分), 此属性对以下注释的外观不起作用: 注记、高亮、下划线、删除线、波浪线、印章、插入符、弹出窗口、文件附件、PSInk、编辑。 对于墨迹注释,只有边框宽度对墨迹注释的外观有影响。
| [in] | border | 要设置的新边框信息。应为有效的边框信息对象。 如果参数 border 的任何值无效,此函数将无法为当前注释设置新边框信息。 |
|
inline |
设置内容。
对于自由文本注释和直线注释(已启用标题), 它们会在外观中显示内容。因此,对于这些类型的注释,此属性会 影响注释的外观。如果用户希望效果显示在 这些类型注释的外观中,请在设置新内容后调用函数Annot.ResetAppearanceStream 。
| [in] | content | 要设置的新内容字符串。 |
|
inline |
|
inline |
设置最后修改日期时间。
| [in] | date_time | 要设置的数据时间。它应该包含有效的日期时间数据。 |
|
inline |
设置唯一ID。
| [in] | unique_id | 要设置的新唯一ID字符串。 |