Foxit PDF SDK
foxit.addon.accessibility.TagTreeEditor类 参考
类 foxit.addon.accessibility.TagTreeEditor 继承关系图:
foxit.common.Base

Public 类型

enum  ArtifactAttachToSideType {
  ArtifactAttachToSideType.e_ArtifactAttachToSideTypeNone = 0, ArtifactAttachToSideType.e_ArtifactAttachToSideTypeLeft = 1, ArtifactAttachToSideType.e_ArtifactAttachToSideTypeTop = 2, ArtifactAttachToSideType.e_ArtifactAttachToSideTypeRight = 3,
  ArtifactAttachToSideType.e_ArtifactAttachToSideTypeBottom = 4
}
 人工元素附着边类型枚举。 更多...
 
enum  ArtifactType { ArtifactType.e_ArtifactTypePage = 0, ArtifactType.e_ArtifactTypePagination = 1, ArtifactType.e_ArtifactTypeLayout = 2 }
 人工元素(Artifact)类型枚举。 更多...
 

Public 成员函数

 TagTreeEditor (PDFDoc pdf_doc)
 构造函数。 更多...
 
 TagTreeEditor (TagTreeEditor other)
 构造函数,使用另一个标签编辑器对象构造。 更多...
 
TagTreeItemArray AddNewTag (string selected_tag_id, string type, string title)
 向标签树添加一个新标签。 更多...
 
TagTreeItemArray AddTagForAnnotation (bool is_tag_annotations, Annot annot, int page_index, string selected_tag_id)
 为注释添加标签。 更多...
 
bool ChangeTagToArtifact (StringArray selected_tag_ids, TagTreeEditor.ArtifactType artifact_type, TagTreeEditor.ArtifactAttachToSideType artifact_to_side)
 将标签更改为人工元素。 更多...
 
TagTreeItemArray CreateTagFromSelectionByContent (StringArray selected_content_ids, string selected_tag_id)
 根据内容从选中内容创建标签。 更多...
 
TagTreeItemArray CreateTagFromSelectionByElement (int page_index, string selected_tag_id)
 根据元素从选中内容创建标签。 更多...
 
TagTreeItemArray CreateTagFromSelectionByTag (StringArray selected_tag_ids, string last_selected_tag_id)
 根据标签从选中内容创建标签。 更多...
 
TagTreeItemArray CreateTagFromSelectionByText (int page_index, RectFArray selected_text_rects, string selected_tag_id)
 根据文本从选中内容创建标签。 更多...
 
TagTreeItemArray DeleteEmptyTags (StringArray selected_tag_ids)
 从标签树中删除空标签。 更多...
 
TagTreeItemArray DeleteTags (StringArray selected_tag_ids)
 从标签树中删除指定的标签。 更多...
 
StringArray FindTagFromSelection (StringArray selected_tag_ids)
 根据选中内容查找标签。 更多...
 
string GetAllContents (string selected_tag_id)
 获取指定标签项的所有内容。 更多...
 
StringArray GetContentTreeItemIDsByTagItemID (string selected_tag_id)
 根据标签项 ID 获取内容树项 ID。 更多...
 
TagProperty GetTagPropertyByID (string item_id)
 根据标签项 ID 获取标签属性。 更多...
 
TagTreeItemArray GetTagTree ()
 获取当前 PDF 文档的标签树。 更多...
 
TagTreeMenuItemDataArray GetTagTreeContextMenuItems (TagTreeMenuInputData input_data)
 获取标签树的右键菜单项。 更多...
 
bool IsEmpty ()
 检查当前对象是否为空。 更多...
 
TagTreeItemArray MoveTags (StringArray source_tag_ids, string dest_tag_id, bool is_moved_as_child)
 在标签树中移动标签。 更多...
 
bool SetDocAsTaggedPDF ()
 将当前 PDF 文档设置为已标记 PDF。 更多...
 
bool SetTagPropertyActualText (string item_id, string actual_text)
 为指定标签项设置标签属性的实际文本。 更多...
 
bool SetTagPropertyAlternateText (string item_id, string alternate_text)
 为指定标签项设置标签属性的替代文本。 更多...
 
bool SetTagPropertyID (string item_id, string id)
 为指定标签项设置标签属性的 ID。 更多...
 
bool SetTagPropertyLanguage (string item_id, string language)
 为指定标签项设置标签属性的语言。 更多...
 
bool SetTagPropertyTitle (string item_id, string title)
 为指定标签项设置标签属性的标题。 更多...
 
bool SetTagPropertyType (string item_id, string type)
 为指定标签项设置标签属性的类型。 更多...
 

详细描述

此类用于让用户编辑 PDF 文档的标签树(结构树):查询和修改标签 属性、添加/删除/移动标签、根据选中内容创建标签、将标签更改为人工元素以及 将文档标记为已标记 PDF。 在使用此模块中的任何类或方法之前,请确保已通过 common.Library.Initialize 函数并使用包含 "Accessibility" 模块的密钥成功初始化福昕 PDF SDK。

参见
foxit.common.Library

成员枚举类型说明

◆ ArtifactAttachToSideType

人工元素附着边类型枚举。

此枚举的值应单独使用。

枚举值
e_ArtifactAttachToSideTypeNone 

人工元素附着边:无。

e_ArtifactAttachToSideTypeLeft 

人工元素附着边:左侧。

e_ArtifactAttachToSideTypeTop 

人工元素附着边:顶部。

e_ArtifactAttachToSideTypeRight 

人工元素附着边:右侧。

e_ArtifactAttachToSideTypeBottom 

人工元素附着边:底部。

◆ ArtifactType

人工元素(Artifact)类型枚举。

此枚举的值应单独使用。

枚举值
e_ArtifactTypePage 

人工元素类型:页面级人工元素。

e_ArtifactTypePagination 

人工元素类型:与分页相关的人工元素(如页眉/页脚)。

e_ArtifactTypeLayout 

人工元素类型:版式人工元素(视觉版式元素)。

构造及析构函数说明

◆ TagTreeEditor() [1/2]

foxit.addon.accessibility.TagTreeEditor.TagTreeEditor ( PDFDoc  pdf_doc)
inline

构造函数。

参数
[in]pdf_doc有效的 PDF 文档对象。

◆ TagTreeEditor() [2/2]

foxit.addon.accessibility.TagTreeEditor.TagTreeEditor ( TagTreeEditor  other)
inline

构造函数,使用另一个标签编辑器对象构造。

参数
[in]other另一个标签编辑器对象。

成员函数说明

◆ AddNewTag()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.AddNewTag ( string  selected_tag_id,
string  type,
string  title 
)
inline

向标签树添加一个新标签。

参数
[in]selected_tag_id作为父级的已选中标签 ID。
[in]type标签类型。
[in]title标签标题。
返回
更新后的标签树项数组。

◆ AddTagForAnnotation()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.AddTagForAnnotation ( bool  is_tag_annotations,
Annot  annot,
int  page_index,
string  selected_tag_id 
)
inline

为注释添加标签。

参数
[in]is_tag_annotations是否为注释添加标签。
[in]annot注释对象。
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]selected_tag_id已选中的标签 ID。
返回
更新后的标签树项数组。

◆ ChangeTagToArtifact()

bool foxit.addon.accessibility.TagTreeEditor.ChangeTagToArtifact ( StringArray  selected_tag_ids,
TagTreeEditor.ArtifactType  artifact_type,
TagTreeEditor.ArtifactAttachToSideType  artifact_to_side 
)
inline

将标签更改为人工元素。

参数
[in]selected_tag_ids已选中的标签 ID 集合。
[in]artifact_type人工元素类型。请参考 。
[in]artifact_to_side人工元素附着边类型。 请参考 。
返回
true 表示成功,false 表示失败。

◆ CreateTagFromSelectionByContent()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.CreateTagFromSelectionByContent ( StringArray  selected_content_ids,
string  selected_tag_id 
)
inline

根据内容从选中内容创建标签。

参数
[in]selected_content_ids已选中的内容 ID 集合。
[in]selected_tag_id已选中的标签 ID。
返回
更新后的标签树项数组。

◆ CreateTagFromSelectionByElement()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.CreateTagFromSelectionByElement ( int  page_index,
string  selected_tag_id 
)
inline

根据元素从选中内容创建标签。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]selected_tag_id已选中的标签 ID。
返回
更新后的标签树项数组。

◆ CreateTagFromSelectionByTag()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.CreateTagFromSelectionByTag ( StringArray  selected_tag_ids,
string  last_selected_tag_id 
)
inline

根据标签从选中内容创建标签。

参数
[in]selected_tag_ids已选中的标签 ID 集合。
[in]last_selected_tag_id最后一个被选中的标签 ID。
返回
更新后的标签树项数组。

◆ CreateTagFromSelectionByText()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.CreateTagFromSelectionByText ( int  page_index,
RectFArray  selected_text_rects,
string  selected_tag_id 
)
inline

根据文本从选中内容创建标签。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]selected_text_rects已选中文本的矩形集合。
[in]selected_tag_id已选中的标签 ID。
返回
更新后的标签树项数组。

◆ DeleteEmptyTags()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.DeleteEmptyTags ( StringArray  selected_tag_ids)
inline

从标签树中删除空标签。

参数
[in]selected_tag_ids用于检查空标签的标签 ID 数组。
返回
更新后的标签树项数组。

◆ DeleteTags()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.DeleteTags ( StringArray  selected_tag_ids)
inline

从标签树中删除指定的标签。

参数
[in]selected_tag_ids待删除标签 ID 的数组。
返回
更新后的标签树项数组。

◆ FindTagFromSelection()

StringArray foxit.addon.accessibility.TagTreeEditor.FindTagFromSelection ( StringArray  selected_tag_ids)
inline

根据选中内容查找标签。

参数
[in]selected_tag_ids已选中的标签 ID 集合。
返回
找到的标签 ID 数组。

◆ GetAllContents()

string foxit.addon.accessibility.TagTreeEditor.GetAllContents ( string  selected_tag_id)
inline

获取指定标签项的所有内容。

参数
[in]selected_tag_id已选中的标签 ID。
返回
内容文本。

◆ GetContentTreeItemIDsByTagItemID()

StringArray foxit.addon.accessibility.TagTreeEditor.GetContentTreeItemIDsByTagItemID ( string  selected_tag_id)
inline

根据标签项 ID 获取内容树项 ID。

参数
[in]selected_tag_id已选中的标签 ID。
返回
内容树项 ID 的数组。

◆ GetTagPropertyByID()

TagProperty foxit.addon.accessibility.TagTreeEditor.GetTagPropertyByID ( string  item_id)
inline

根据标签项 ID 获取标签属性。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
返回
标签属性对象。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。

◆ GetTagTree()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.GetTagTree ( )
inline

获取当前 PDF 文档的标签树。

返回
标签树项数组。

◆ GetTagTreeContextMenuItems()

TagTreeMenuItemDataArray foxit.addon.accessibility.TagTreeEditor.GetTagTreeContextMenuItems ( TagTreeMenuInputData  input_data)
inline

获取标签树的右键菜单项。

参数
[in]input_data右键菜单的输入数据。
返回
菜单项数据的数组。

◆ IsEmpty()

bool foxit.addon.accessibility.TagTreeEditor.IsEmpty ( )
inline

检查当前对象是否为空。

当前对象为空时,表示当前对象不可用。

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

◆ MoveTags()

TagTreeItemArray foxit.addon.accessibility.TagTreeEditor.MoveTags ( StringArray  source_tag_ids,
string  dest_tag_id,
bool  is_moved_as_child 
)
inline

在标签树中移动标签。

参数
[in]dest_tag_id目标标签 ID。
[in]is_moved_as_child是否作为目标的子项移动。
返回
更新后的标签树项数组。

◆ SetDocAsTaggedPDF()

bool foxit.addon.accessibility.TagTreeEditor.SetDocAsTaggedPDF ( )
inline

将当前 PDF 文档设置为已标记 PDF。

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

◆ SetTagPropertyActualText()

bool foxit.addon.accessibility.TagTreeEditor.SetTagPropertyActualText ( string  item_id,
string  actual_text 
)
inline

为指定标签项设置标签属性的实际文本。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
[in]actual_text要设置的实际文本。
返回
true 表示成功,false 表示失败。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。

◆ SetTagPropertyAlternateText()

bool foxit.addon.accessibility.TagTreeEditor.SetTagPropertyAlternateText ( string  item_id,
string  alternate_text 
)
inline

为指定标签项设置标签属性的替代文本。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
[in]alternate_text要设置的替代文本。
返回
true 表示成功,false 表示失败。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。

◆ SetTagPropertyID()

bool foxit.addon.accessibility.TagTreeEditor.SetTagPropertyID ( string  item_id,
string  id 
)
inline

为指定标签项设置标签属性的 ID。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
[in]id要设置的 ID。
返回
true 表示成功,false 表示失败。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。

◆ SetTagPropertyLanguage()

bool foxit.addon.accessibility.TagTreeEditor.SetTagPropertyLanguage ( string  item_id,
string  language 
)
inline

为指定标签项设置标签属性的语言。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
[in]language要设置的语言。
返回
true 表示成功,false 表示失败。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。

◆ SetTagPropertyTitle()

bool foxit.addon.accessibility.TagTreeEditor.SetTagPropertyTitle ( string  item_id,
string  title 
)
inline

为指定标签项设置标签属性的标题。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
[in]title要设置的标签标题。
返回
true 表示成功,false 表示失败。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。

◆ SetTagPropertyType()

bool foxit.addon.accessibility.TagTreeEditor.SetTagPropertyType ( string  item_id,
string  type 
)
inline

为指定标签项设置标签属性的类型。

参数
[in]item_id标签项 ID,通过 TagTreeEditor.GetTagTree 返回的条目中的 TagTreeItemData::item_id 获取。
[in]type要设置的标签类型。
返回
true 表示成功,false 表示失败。
注解
item_id 所引用的标签项必须是结构元素(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeElement )节点; 标记内容引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeMarkedContentSeq )、 对象引用(foxit.addon.accessibility.TagTreeItemData.TagNodeType.e_TagNodeTypeObject )等引用类节点不具有该属性,将导致调用失败。