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