Foxit PDF SDK
foxit::pdf::annots::Annot类 参考
类 foxit::pdf::annots::Annot 继承关系图:
foxit::Base foxit::pdf::annots::Link foxit::pdf::annots::Markup foxit::pdf::annots::PagingSeal foxit::pdf::annots::Popup foxit::pdf::annots::PSInk foxit::pdf::annots::Screen foxit::pdf::annots::Widget foxit::pdf::annots::Caret foxit::pdf::annots::Circle foxit::pdf::annots::FileAttachment foxit::pdf::annots::FreeText foxit::pdf::annots::Ink foxit::pdf::annots::Line foxit::pdf::annots::Note foxit::pdf::annots::Polygon foxit::pdf::annots::PolyLine foxit::pdf::annots::Redact foxit::pdf::annots::Sound foxit::pdf::annots::Square foxit::pdf::annots::Stamp foxit::pdf::annots::TextMarkup

Public 类型

enum  AppearanceType { e_AppearanceTypeNormal = 0, e_AppearanceTypeRollover = 1, e_AppearanceTypeDown = 2 }
 注释外观类型的枚举。 更多...
 
enum  Flags {
  e_FlagInvisible = 0x0001, e_FlagHidden = 0x0002, e_FlagPrint = 0x0004, e_FlagNoZoom = 0x0008,
  e_FlagNoRotate = 0x0010, e_FlagNoView = 0x0020, e_FlagReadOnly = 0x0040, e_FlagLocked = 0x0080,
  e_FlagToggleNoView = 0x0100, e_FlagLockedContents = 0x0200
}
 PDF注释标志的枚举。 更多...
 
enum  HighlightingMode {
  e_HighlightingNone = 0, e_HighlightingInvert = 1, e_HighlightingOutline = 2, e_HighlightingPush = 3,
  e_HighlightingToggle = 4
}
 PDF注释高亮模式的枚举。 更多...
 
enum  MKEntry {
  e_MKEntryRotation = 0, e_MKEntryBorderColor = 1, e_MKEntryBackgroundColor = 2, e_MKEntryNormalCaption = 3,
  e_MKEntryRolloverCaption = 4, e_MKEntryDownCaption = 5, e_MKEntryNormalIcon = 6, e_MKEntryRolloverIcon = 7,
  e_MKEntryDownIcon = 8, e_MKEntryIconFit = 9, e_MKEntryIconCaptionRelation = 10
}
 注释MK字典(外观特征)条目的枚举。 更多...
 
enum  MKIconCaptionRelation {
  e_MKRelationNoIcon = 0, e_MKRelationNoCaption = 1, e_MKRelationCaptionBelowIcon = 2, e_MKRelationCaptionAboveIcon = 3,
  e_MKRelationCaptionRight = 4, e_MKRelationCaptionLeft = 5, e_MKRelationCaptionOvrlayOnIcon = 6
}
 注释MK字典中图标和标题相对位置的枚举。 更多...
 
enum  Property { e_PropertyModifiedDate = 0, e_PropertyCreationDate = 1, e_PropertyBorderColor = 2, e_PropertyFillColor = 3 }
 某些PDF注释属性的枚举。 更多...
 
enum  Type {
  e_UnknownType = 0, e_Note = 1, e_Link = 2, e_FreeText = 3,
  e_Line = 4, e_Square = 5, e_Circle = 6, e_Polygon = 7,
  e_PolyLine = 8, e_Highlight = 9, e_Underline = 10, e_Squiggly = 11,
  e_StrikeOut = 12, e_Stamp = 13, e_Caret = 14, e_Ink = 15,
  e_PSInk = 16, e_FileAttachment = 17, e_Sound = 18, e_Movie = 19,
  e_Widget = 20, e_Screen = 21, e_PrinterMark = 22, e_TrapNet = 23,
  e_Watermark = 24, e_3D = 25, e_Popup = 26, e_Redact = 27,
  e_RichMedia = 28, e_PagingSeal = 29
}
 PDF注释类型的枚举。 更多...
 

Public 成员函数

 Annot (const PDFPage &page, objects::PDFDictionary *annot_dict)
 构造函数,使用PDF页面和注释的PDF字典。 更多...
 
 Annot (const Annot &annot)
 构造函数,使用另一个注释对象。 更多...
 
 Annot ()
 构造函数。
 
virtual ~Annot ()
 析构函数。
 
objects::PDFStreamGetAppearanceStream (AppearanceType type, const char *appearance_state="") const
 获取具有指定类型和状态的注释外观流。 更多...
 
RGB GetBorderColor () const
 获取边框颜色。 更多...
 
BorderInfo GetBorderInfo () const
 获取边框信息。 更多...
 
WString GetContent () const
 获取内容。 更多...
 
RectI GetDeviceRect (const Matrix &matrix)
 获取设备坐标系统中的注释矩形。 更多...
 
objects::PDFDictionaryGetDict () const
 获取注释的字典对象。 更多...
 
Matrix GetDisplayMatrix (const Matrix &page_display_matrix)
 获取显示矩阵,从PDF坐标系统到 目标设备坐标系统。 更多...
 
uint32 GetFlags () const
 获取注释标志。 更多...
 
int GetIndex () const
 获取当前注释在其所属页面中的索引。 更多...
 
DateTime GetModifiedDateTime () const
 获取最后修改日期时间。 更多...
 
objects::PDFDictionaryGetOptionalContent () 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
 不等于运算符。 更多...
 
Annotoperator= (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。
此类对象也可用于构造其他类的对象,以便在注释中进行更多操作 或访问注释的指定信息:

注解
目前,以下类型的函数仅支持注记、高亮、下划线、删除线、波浪线、链接、 矩形、圆形、自由文本、印章、插入符、墨迹、直线、多边形、折线、文件附件、弹出窗口、 小组件、屏幕、PSInk、编辑注释:
参见
pdf::PDFPage
actions::AdditionalAction
pdf::TextSearch

成员枚举类型说明

◆ AppearanceType

注释外观类型的枚举。

此枚举的值应单独使用。

枚举值
e_AppearanceTypeNormal 

注释的正常外观。

e_AppearanceTypeRollover 

注释的悬停外观。

e_AppearanceTypeDown 

注释的按下外观。

◆ Flags

PDF注释标志的枚举。

此枚举的值可以单独使用或组合使用。

枚举值
e_FlagInvisible 

注释标志:不可见。

如果设置,当注释不属于标准注释类型且没有可用的注释处理程序时,不显示该注释。 如果清除,则使用其外观字典指定的外观流显示此类非标准注释(如果有)。

e_FlagHidden 

注释标志:隐藏。

如果设置,不显示或打印注释或允许用户与其交互, 无论其注释类型如何或是否有可用的注释处理程序。

e_FlagPrint 

注释标志:打印。

如果设置,打印页面时打印注释。如果清除,从不打印注释, 无论它是否显示在屏幕上。这可能很有用,例如, 对于表示交互式按钮的注释,这些按钮在打印页面上没有意义。

e_FlagNoZoom 

注释标志:无缩放。

如果设置,不根据页面的放大倍数缩放注释的外观。 注释在页面上的位置(由其注释矩形的左上角定义) 保持固定,无论页面放大倍数如何。

e_FlagNoRotate 

注释标志:无旋转。

如果设置,不根据页面的旋转旋转注释的外观。 注释矩形的左上角在页面上保持固定位置, 无论页面旋转如何。

e_FlagNoView 

注释标志:无视图。

如果设置,不在屏幕上显示注释或允许用户与其交互。 注释可能被打印(取决于标志Annot::e_FlagPrint的设置), 但在屏幕显示和用户交互方面应被视为隐藏。

e_FlagReadOnly 

注释标志:只读。

如果设置,不允许注释与用户交互。注释可能显示或打印 (取决于标志Annot::e_FlagNoViewAnnot::e_FlagPrint的设置), 但不应响应鼠标点击或响应鼠标移动而改变其外观。

注解
对于小组件注释,此标志被忽略;其功能被相关表单字段的标志 interform::Field::e_FlagReadOnly取代。
e_FlagLocked 

注释标志:锁定。

如果设置,不允许用户删除注释或修改其属性(包括位置和大小)。 但是,此标志不限制对注释内容的更改,例如表单字段的值。

e_FlagToggleNoView 

注释标志:切换无视图。

如果设置,为某些事件反转NoView标志的解释。一个典型用途是 使注释仅在鼠标光标悬停在其上时出现。

e_FlagLockedContents 

注释标志:锁定内容。

如果设置,不允许用户修改注释的内容。 此标志不限制删除注释或更改其他注释属性,例如位置和大小。

◆ HighlightingMode

PDF注释高亮模式的枚举。

此枚举的值应单独使用。

枚举值
e_HighlightingNone 

高亮模式:无高亮。

e_HighlightingInvert 

高亮模式:反转,即反转注释矩形的内容。

e_HighlightingOutline 

高亮模式:轮廓,即反转注释的边框。

e_HighlightingPush 

高亮模式:按下,即显示注释的按下外观(如果有)。

e_HighlightingToggle 

高亮模式:切换。这仅对小组件注释有用。

◆ MKEntry

注释MK字典(外观特征)条目的枚举。

此枚举的值应单独使用。

枚举值
e_MKEntryRotation 

旋转条目。MK字典中的"R"。

e_MKEntryBorderColor 

边框颜色条目。MK字典中的"BC"。

e_MKEntryBackgroundColor 

背景颜色条目。MK字典中的"BG"。

e_MKEntryNormalCaption 

正常标题条目。MK字典中的"CA"。

注解
仅适用于与按钮字段、复选框字段或单选按钮字段关联的小组件注释。
e_MKEntryRolloverCaption 

悬停标题条目。MK字典中的"RC"。

注解
仅适用于与按钮字段关联的小组件注释。
e_MKEntryDownCaption 

按下标题(或备用标题)条目。MK字典中的"AC"。

注解
仅适用于与按钮字段关联的小组件注释。
e_MKEntryNormalIcon 

正常图标条目。MK字典中的"I"。

注解
仅适用于与按钮字段关联的小组件注释。
e_MKEntryRolloverIcon 

悬停图标条目。MK字典中的"RI"。

注解
仅适用于与按钮字段关联的小组件注释。
e_MKEntryDownIcon 

按下图标(或备用图标)条目。MK字典中的"IX"。

注解
仅适用于与按钮字段关联的小组件注释。
e_MKEntryIconFit 

图标适配信息条目。MK字典中的"IF"。

注解
仅适用于与按钮字段关联的小组件注释。
e_MKEntryIconCaptionRelation 

图标和标题关系条目。MK字典中的"TP"。

注解
仅适用于与按钮字段关联的小组件注释。 用于指定小组件注释的mk标题文本相对于小组件注释的mk图标的位置。

◆ MKIconCaptionRelation

注释MK字典中图标和标题相对位置的枚举。

此枚举的值应单独使用。

枚举值
e_MKRelationNoIcon 

无图标;仅标题。

e_MKRelationNoCaption 

无标题;仅图标。

e_MKRelationCaptionBelowIcon 

标题在图标下方。

e_MKRelationCaptionAboveIcon 

标题在图标上方。

e_MKRelationCaptionRight 

标题在图标右侧。

e_MKRelationCaptionLeft 

标题在图标左侧。

e_MKRelationCaptionOvrlayOnIcon 

标题直接覆盖在图标上。

◆ Property

某些PDF注释属性的枚举。

此枚举的值应单独使用。

枚举值
e_PropertyModifiedDate 

注释属性:修改日期。

e_PropertyCreationDate 

注释属性:创建日期。

只有标记注释可以具有创建日期属性。

e_PropertyBorderColor 

注释属性:边框颜色。

自由文本注释可以具有边框颜色属性,但 不支持从自由文本注释中删除此属性。

e_PropertyFillColor 

注释属性:填充颜色

只有以下类型的注释可以具有填充颜色属性:
正方形、圆形、自由文本、线条、多边形、折线、编辑。

◆ Type

PDF注释类型的枚举。

此枚举的值应单独使用。

枚举值
e_UnknownType 

注释类型:未知。

e_Note 

注释类型:注记注释,即"文本"注释 - <PDF参考1.7>中的标准注释之一。

e_Link 

注释类型:链接注释。<PDF参考1.7>中的标准注释之一。

e_FreeText 

注释类型:自由文本注释。<PDF参考1.7>中的标准注释之一。

e_Line 

注释类型:直线注释。<PDF参考1.7>中的标准注释之一。

e_Square 

注释类型:矩形注释。<PDF参考1.7>中的标准注释之一。

e_Circle 

注释类型:圆形注释。<PDF参考1.7>中的标准注释之一。

e_Polygon 

注释类型:多边形注释。<PDF参考1.7>中的标准注释之一。

e_PolyLine 

注释类型:折线注释。<PDF参考1.7>中的标准注释之一。

e_Highlight 

注释类型:高亮注释。<PDF参考1.7>中的标准注释之一。

e_Underline 

注释类型:下划线注释。<PDF参考1.7>中的标准注释之一。

e_Squiggly 

注释类型:波浪线注释。<PDF参考1.7>中的标准注释之一。

e_StrikeOut 

注释类型:删除线注释。<PDF参考1.7>中的标准注释之一。

e_Stamp 

注释类型:印章注释。<PDF参考1.7>中的标准注释之一。

e_Caret 

注释类型:插入符注释。<PDF参考1.7>中的标准注释之一。

e_Ink 

注释类型:墨迹注释。<PDF参考1.7>中的标准注释之一。

e_PSInk 

注释类型:压力敏感墨迹注释。

e_FileAttachment 

注释类型:文件附件注释。<PDF参考1.7>中的标准注释之一。

e_Sound 

注释类型:声音注释。<PDF参考1.7>中的标准注释之一。

e_Movie 

注释类型:电影注释。<PDF参考1.7>中的标准注释之一。

e_Widget 

注释类型:小组件注释。<PDF参考1.7>中的标准注释之一。

注解
福昕PDF SDK将小组件注释视为表单控件。
e_Screen 

注释类型:屏幕注释。<PDF参考1.7>中的标准注释之一。

e_PrinterMark 

注释类型:印刷标记注释。<PDF参考1.7>中的标准注释之一。

e_TrapNet 

注释类型:陷阱网络注释。<PDF参考1.7>中的标准注释之一。

e_Watermark 

注释类型:水印注释。<PDF参考1.7>中的标准注释之一。

e_3D 

注释类型:3D注释。<PDF参考1.7>中的标准注释之一。

e_Popup 

注释类型:弹出注释。<PDF参考1.7>中的标准注释之一。

e_Redact 

注释类型:编辑注释。

e_RichMedia 

注释类型:富媒体注释。

e_PagingSeal 

注释类型:分页印章注释。福昕PDF SDK自定义注释类型(非标准注释类型)。

构造及析构函数说明

◆ Annot() [1/2]

foxit::pdf::annots::Annot::Annot ( const PDFPage page,
objects::PDFDictionary annot_dict 
)

构造函数,使用PDF页面和注释的PDF字典。

参数
[in]page有效的PDF页面。
[in]annot_dict注释的PDF字典。它应该表示一个注释,并且应该在 参数page指定的PDF页面中。

◆ Annot() [2/2]

foxit::pdf::annots::Annot::Annot ( const Annot annot)

构造函数,使用另一个注释对象。

参数
[in]annot另一个注释对象。

成员函数说明

◆ GetAppearanceStream()

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"(外观状态)条目指定的外观状态。
返回
指定的注释外观流。 如果没有与外观相关的条目或发生任何错误,此函数将返回 NULL

◆ GetBorderColor()

RGB foxit::pdf::annots::Annot::GetBorderColor ( ) const

获取边框颜色。

此属性对注释的外观有影响。

返回
边框颜色。格式:0xRRGGBB。 如果找不到边框颜色,将返回0x000000。

◆ GetBorderInfo()

BorderInfo foxit::pdf::annots::Annot::GetBorderInfo ( ) const

获取边框信息。

此属性对注释的外观有影响。对于没有边框信息的注释,将返回默认边框信息:
边框宽度 = 1,边框样式 = BorderInfo::e_Solid, 边框云状强度 = 0,边框虚线相位 = 0,边框虚线数组为空数组。 注意:在支持的注释类型中(请参考类 Annot 的"注意"注释部分), 此属性对以下注释的外观不起作用: 注记、高亮、下划线、删除线、波浪线、印章、插入符、弹出窗口、文件附件、PSInk、编辑。 对于墨迹注释,只有边框宽度对墨迹注释的外观有影响。

返回
接收边框信息的边框信息对象。如果找不到任何边框信息,将返回"详细信息"部分所述的默认边框信息。

◆ GetContent()

WString foxit::pdf::annots::Annot::GetContent ( ) const

获取内容。

返回
内容字符串。

◆ GetDeviceRect()

RectI foxit::pdf::annots::Annot::GetDeviceRect ( const Matrix matrix)

获取设备坐标系统中的注释矩形。

这是获取注释的设备矩形的有用函数, 但不支持弹出注释。
对于矩形转换,结果矩形始终是"标准化的",即 使用设备坐标系统:左侧始终小于右侧,顶部始终小于底部。

参数
[in]matrix用于从PDF坐标系统转换到 设备坐标系统的矩阵。通常,这由函数 pdf::PDFPage::GetDisplayMatrix返回,也用于渲染。
返回
设备坐标系统中的注释矩形。 如果没有矩形信息,将返回所有值为0的RectI对象。

◆ GetDict()

objects::PDFDictionary* foxit::pdf::annots::Annot::GetDict ( ) const

获取注释的字典对象。

返回
注释的字典。如果有任何错误,此函数将返回NULL

◆ GetDisplayMatrix()

Matrix foxit::pdf::annots::Annot::GetDisplayMatrix ( const Matrix page_display_matrix)

获取显示矩阵,从PDF坐标系统到 目标设备坐标系统。

当前注释的显示矩阵可以与注释的矩形一起使用, 以计算注释在目标设备坐标系统中的实际区域。

参数
[in]page_display_matrixThe transformation matrix. Usually this is returned by function PDFPage::GetDisplayMatrix.
返回
The display matrix of current annotation.

◆ GetFlags()

uint32 foxit::pdf::annots::Annot::GetFlags ( ) const

获取注释标志。

返回
注释标志。请参考从Annot::e_FlagInvisible开始的值, 这将是这些值中的一个或组合。0表示无注释标志。

◆ GetIndex()

int foxit::pdf::annots::Annot::GetIndex ( ) const

获取当前注释在其所属页面中的索引。

返回
索引值,从0开始。

◆ GetModifiedDateTime()

DateTime foxit::pdf::annots::Annot::GetModifiedDateTime ( ) const

获取最后修改日期时间。

返回
接收最后修改日期时间的日期和时间对象。 如果没有修改日期时间信息,将返回所有值为0的日期和时间对象。

◆ GetOptionalContent()

objects::PDFDictionary* foxit::pdf::annots::Annot::GetOptionalContent ( ) const

获取注释可选内容的PDF字典。

返回
注释可选内容的PDF字典。 如果没有"OC"条目或发生任何错误,此函数将返回 NULL

◆ GetPage()

PDFPage foxit::pdf::annots::Annot::GetPage ( ) const

获取相关的PDF页面。

返回
作为相关PDF页面的PDF页面对象。

◆ GetRect()

RectF foxit::pdf::annots::Annot::GetRect ( ) const

获取矩形,以PDF坐标系统表示。

返回
注释矩形。 如果没有矩形信息,将返回所有值为0的RectF对象。

◆ GetType()

Type foxit::pdf::annots::Annot::GetType ( ) const

获取当前注释的实际注释类型。

返回
注释类型。请参考从Annot::e_Note开始的值,这将是这些值中的一个。

◆ GetUniqueID()

WString foxit::pdf::annots::Annot::GetUniqueID ( ) const

获取唯一ID。

返回
唯一ID字符串。

◆ HasProperty()

bool foxit::pdf::annots::Annot::HasProperty ( Property  property) const

当前注释是否具有指定的注释属性。

参数
[in]property属性名称。请参考从Annot::e_PropertyModifiedDate开始的值, 这应该是这些值中的一个。
返回
true表示当前注释具有指定的属性, 而false表示当前注释没有指定的属性。

◆ IsEmpty()

bool foxit::pdf::annots::Annot::IsEmpty ( ) const

检查当前对象是否为空。

当当前对象为空时,这意味着当前对象是无用的。

返回
true表示当前对象为空,而false表示不为空。

◆ IsMarkup()

bool foxit::pdf::annots::Annot::IsMarkup ( ) const

检查当前注释是否为标记注释。

返回
true表示当前注释是标记注释,而false表示当前注释 不是标记注释。

◆ Move() [1/2]

bool foxit::pdf::annots::Annot::Move ( const RectF rect)

将当前注释移动到新位置,由PDF坐标系统中的新矩形指定。

参数
[in]rect指定当前注释要移动到的新位置的新矩形。 它应该在PDF坐标系统中有效。
返回
true表示成功,而false表示失败。

◆ Move() [2/2]

bool foxit::pdf::annots::Annot::Move ( const RectF rect,
bool  is_reset_appearance 
)

将当前注释移动到新位置,由PDF坐标系统中的新矩形指定。

参数
[in]rect指定当前注释要移动到的新位置的新矩形。 它应该在PDF坐标系统中有效。
[in]is_reset_appearance布尔值,指定移动后是否重置注释的外观。
返回
true表示成功,而false表示失败。

◆ operator !=()

bool foxit::pdf::annots::Annot::operator != ( const Annot other) const

不等于运算符。

参数
[in]other另一个注释对象。此函数将检查当前对象是否不等于此对象。
返回
true表示不相等,而false表示相等。

◆ operator=()

Annot& foxit::pdf::annots::Annot::operator= ( const Annot annot)

赋值运算符。

参数
[in]annot另一个注释对象,其值将赋值给当前对象。
返回
对当前对象自身的引用。

◆ operator==()

bool foxit::pdf::annots::Annot::operator== ( const Annot other) const

等于运算符。

参数
[in]other另一个注释对象。此函数将检查当前对象是否等于此对象。
返回
true表示相等,而false表示不相等。

◆ RemoveProperty()

bool foxit::pdf::annots::Annot::RemoveProperty ( Property  property)

删除指定的注释属性。

此函数可用于删除注释的某些可选属性。 当成功删除与外观相关的属性时,例如 Annot::e_PropertyBorderColorAnnot::e_PropertyFillColor, 用户应调用函数 Annot::ResetAppearanceStream 以在注释外观上产生效果。

参数
[in]property属性名称。请参考从 Annot::e_PropertyModifiedDate 开始的值, 应为这些值中的一个。
返回
true 表示成功删除指定属性,或当前注释支持该属性但没有该属性。
false 表示当前注释不支持拥有指定属性,或当前注释无法删除指定属性。

◆ ResetAppearanceStream() [1/2]

bool foxit::pdf::annots::Annot::ResetAppearanceStream ( )

重置外观流。

注释的外观作为流存储在PDF文档中。 任何与外观相关的属性都可以通过相应的设置函数进行更改。 为了使此更改生效,应调用此函数来更新注释的外观。
请查看类 Annot 注释中的"注意"部分,了解哪些类型的注释可以 通过当前函数重置外观,并检查这些注释类的注释,以了解在重置外观流之前是否需要任何属性。

返回
true 表示成功,false 表示失败。

◆ ResetAppearanceStream() [2/2]

bool foxit::pdf::annots::Annot::ResetAppearanceStream ( bool  is_generate_new_appearance_obj)

重置外观流。

注释的外观作为流存储在PDF文档中。 任何与外观相关的属性都可以通过相应的设置函数进行更改。 为了使此更改生效,应调用此函数来更新注释的外观。
请查看类 Annot 注释中的"注意"部分,了解哪些类型的注释可以 通过当前函数重置外观,并检查这些注释类的注释,以了解在重置外观流之前是否需要任何属性。

参数
[in]is_generate_new_appearance_objtrue 表示生成新的外观对象来重置当前注释的外观, false 表示重置共享此外观流的注释的外观。 该参数仅对小组件注释的外观有影响。
返回
true 表示成功,false 表示失败。

◆ SetBorderColor()

void foxit::pdf::annots::Annot::SetBorderColor ( RGB  color)

设置边框颜色。

此属性对注释的外观有影响。如果用户希望新的边框颜色对 注释的外观有影响,请在设置新边框颜色后调用函数Annot::ResetAppearanceStream

参数
[in]color要设置的新边框颜色。格式:0xRRGGBB。
返回
无。

◆ SetBorderInfo()

void foxit::pdf::annots::Annot::SetBorderInfo ( const BorderInfo border)

设置边框信息。

此属性对注释的外观有影响。如果用户希望新的边框信息对注释的外观有影响, 请在设置新边框信息后调用函数 Annot::ResetAppearanceStream
注意:在支持的注释类型中(请参考类 Annot 的"注意"注释部分), 此属性对以下注释的外观不起作用: 注记、高亮、下划线、删除线、波浪线、印章、插入符、弹出窗口、文件附件、PSInk、编辑。 对于墨迹注释,只有边框宽度对墨迹注释的外观有影响。

参数
[in]border要设置的新边框信息。应为有效的边框信息对象。 如果参数 border 的任何值无效,此函数将无法为当前注释设置新边框信息。
返回
无。

◆ SetContent()

void foxit::pdf::annots::Annot::SetContent ( const WString content)

设置内容。

对于自由文本注释和直线注释(已启用标题), 它们会在外观中显示内容。因此,对于这些类型的注释,此属性会 影响注释的外观。如果用户希望效果显示在 这些类型注释的外观中,请在设置新内容后调用函数Annot::ResetAppearanceStream

参数
[in]content要设置的新内容字符串。
返回
无。

◆ SetFlags()

void foxit::pdf::annots::Annot::SetFlags ( uint32  flags)

设置注释标志。

参数
[in]flags注释标志。可以是0,或者是从 Annot::e_FlagInvisible开始的值中的一个或组合。
返回
无。

◆ SetModifiedDateTime()

void foxit::pdf::annots::Annot::SetModifiedDateTime ( const DateTime date_time)

设置最后修改日期时间。

参数
[in]date_time要设置的数据时间。它应该包含有效的日期时间数据。
返回
无。

◆ SetUniqueID()

void foxit::pdf::annots::Annot::SetUniqueID ( const WString unique_id)

设置唯一ID。

参数
[in]unique_id要设置的新唯一ID字符串。
返回
无。