Foxit PDF SDK

Public 成员函数 | 所有成员列表
foxit::pdf::graphics::MarkedContent类 参考

继承自 Object .

## Public 成员函数
| ~MarkedContent ()
| 析构函数。
int | AddItem (const char *tag_name, objects::PDFDictionary *property_dict=0)
| 添加新的标记内容项。 更多...
int | GetItemCount () const
| 获取标记内容项的数量。 更多...
int | GetItemMCID (int index) const
| 根据索引获取指定标记内容项的标记内容标识符(MCID)。 更多...
objects::PDFDictionary * | GetItemPropertyDict (int index) const
| 根据索引获取指定标记内容项的属性字典。 更多...
String | GetItemTagName (int index) const
| 根据索引获取指定标记内容项的标签名称。 更多...
bool | HasTag (const char *tag_name)
| 检查当前标记内容对象是否具有指定的标记内容项。 更多...
bool | RemoveItem (const char *tag_name)
| 根据标签名称删除标记内容项。 更多...

## 详细描述

标记内容操作符(PDF 1.2)将PDF内容流的一部分标识为特定应用程序或PDF插件扩展感兴趣的标记内容元素。 更多详细信息，请参阅<PDF Reference 1.7>第10.5节"标记内容"。
要获取标记内容对象，请使用函数GraphicsObject::GetMarkedContent。

参见
  GraphicsObject

## 成员函数说明

## ◆ AddItem()

int foxit::pdf::graphics::MarkedContent::AddItem | ( | const char * | tag_name,
|  | objects::PDFDictionary * | property_dict = `0`
| ) |  |

添加新的标记内容项。

参数

  [in] | tag_name | 新的标签名称。它不应该是空字符串。 如果参数tag_name在当前标记内容对象中存在， 则不能再次添加到当前标记内容对象中。
  [in] | property_dict | 属性字典。默认值：NULL。 NULL 表示新的标记内容项将没有属性字典。 如果此字典是新创建的且尚未设置给其他对象，用户应在调用此函数后释放此字典对象。

返回
  新添加的标记内容项的索引。如果有任何错误，此函数将返回-1。

## ◆ GetItemCount()

int foxit::pdf::graphics::MarkedContent::GetItemCount | ( |  | ) | const

获取标记内容项的数量。

标记内容对象可能一个嵌套在另一个内部，此函数用于获取当前标记内容序列中标记内容项的数量。

返回
  标记内容项的数量。

## ◆ GetItemMCID()

int foxit::pdf::graphics::MarkedContent::GetItemMCID | ( | int | index | ) | const

根据索引获取指定标记内容项的标记内容标识符(MCID)。

参数

  [in] | index | 项索引。有效范围：从0到(count-1)。 count 由函数MarkedContent::GetItemCount返回。

返回
  MCID值。负数表示指定的标记内容项没有MCID。

## ◆ GetItemPropertyDict()

objects::PDFDictionary* foxit::pdf::graphics::MarkedContent::GetItemPropertyDict | ( | int | index | ) | const

根据索引获取指定标记内容项的属性字典。

参数

  [in] | index | 项索引。有效范围：从0到(count-1)。 count 由函数MarkedContent::GetItemCount返回。

返回
  属性字典。NULL 表示没有属性字典。

## ◆ GetItemTagName()

String foxit::pdf::graphics::MarkedContent::GetItemTagName | ( | int | index | ) | const

根据索引获取指定标记内容项的标签名称。

标记内容对象可能一个嵌套在另一个内部，此函数用于获取当前标记内容序列中标记内容项的数量。

参数

  [in] | index | 项索引。有效范围：从0到(count-1)。 count 由函数MarkedContent::GetItemCount返回。

返回
  标签名称。

## ◆ HasTag()

bool foxit::pdf::graphics::MarkedContent::HasTag | ( | const char * | tag_name | ) |

检查当前标记内容对象是否具有指定的标记内容项。

参数

  [in] | tag_name | 要检查的标签名称。

返回
  true 表示当前标记内容对象具有指定的标记内容项。 false 表示当前标记内容对象不具有指定的标记内容项。

## ◆ RemoveItem()

bool foxit::pdf::graphics::MarkedContent::RemoveItem | ( | const char * | tag_name | ) |

根据标签名称删除标记内容项。

参数

  [in] | tag_name | 标签名称。不应为空字符串。

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