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

Public 成员函数

 TagTreeEditor (PDFDoc pdf_doc) throws com.foxit.sdk.PDFException
 构造函数。
更多...
 
 TagTreeEditor (TagTreeEditor other)
 构造函数,使用另一个标签编辑器对象构造。
更多...
 
TagTreeItemArray addNewTag (String selected_tag_id, String type, String title) throws com.foxit.sdk.PDFException
 向标签树添加一个新标签。
更多...
 
TagTreeItemArray addTagForAnnotation (boolean is_tag_annotations, Annot annot, int page_index, String selected_tag_id) throws com.foxit.sdk.PDFException
 为注释添加标签。
更多...
 
boolean changeTagToArtifact (java.util.ArrayList< java.lang.String > selected_tag_ids, int artifact_type, int artifact_to_side) throws com.foxit.sdk.PDFException
 将标签更改为人工元素。
更多...
 
TagTreeItemArray createTagFromSelectionByContent (java.util.ArrayList< java.lang.String > selected_content_ids, String selected_tag_id) throws com.foxit.sdk.PDFException
 根据内容从选中内容创建标签。
更多...
 
TagTreeItemArray createTagFromSelectionByElement (int page_index, String selected_tag_id) throws com.foxit.sdk.PDFException
 根据元素从选中内容创建标签。
更多...
 
TagTreeItemArray createTagFromSelectionByTag (java.util.ArrayList< java.lang.String > selected_tag_ids, String last_selected_tag_id) throws com.foxit.sdk.PDFException
 根据标签从选中内容创建标签。
更多...
 
TagTreeItemArray createTagFromSelectionByText (int page_index, RectFArray selected_text_rects, String selected_tag_id) throws com.foxit.sdk.PDFException
 根据文本从选中内容创建标签。
更多...
 
synchronized void delete ()
 直接清除C++相关资源。 更多...
 
TagTreeItemArray deleteEmptyTags (java.util.ArrayList< java.lang.String > selected_tag_ids) throws com.foxit.sdk.PDFException
 从标签树中删除空标签。
更多...
 
TagTreeItemArray deleteTags (java.util.ArrayList< java.lang.String > selected_tag_ids) throws com.foxit.sdk.PDFException
 从标签树中删除指定的标签。
更多...
 
java.util.ArrayList< java.lang.String > findTagFromSelection (java.util.ArrayList< java.lang.String > selected_tag_ids) throws com.foxit.sdk.PDFException
 根据选中内容查找标签。
更多...
 
String getAllContents (String selected_tag_id) throws com.foxit.sdk.PDFException
 获取指定标签项的所有内容。
更多...
 
java.util.ArrayList< java.lang.String > getContentTreeItemIDsByTagItemID (String selected_tag_id) throws com.foxit.sdk.PDFException
 根据标签项 ID 获取内容树项 ID。
更多...
 
TagProperty getTagPropertyByID (String item_id) throws com.foxit.sdk.PDFException
 根据标签项 ID 获取标签属性。
更多...
 
TagTreeItemArray getTagTree () throws com.foxit.sdk.PDFException
 获取当前 PDF 文档的标签树。
更多...
 
TagTreeMenuItemDataArray getTagTreeContextMenuItems (TagTreeMenuInputData input_data) throws com.foxit.sdk.PDFException
 获取标签树的右键菜单项。
更多...
 
boolean isEmpty ()
 检查当前对象是否为空。
更多...
 
TagTreeItemArray moveTags (java.util.ArrayList< java.lang.String > source_tag_ids, String dest_tag_id, boolean is_moved_as_child) throws com.foxit.sdk.PDFException
 在标签树中移动标签。
更多...
 
boolean setDocAsTaggedPDF () throws com.foxit.sdk.PDFException
 将当前 PDF 文档设置为已标记 PDF。
更多...
 
boolean setTagPropertyActualText (String item_id, String actual_text) throws com.foxit.sdk.PDFException
 为指定标签项设置标签属性的实际文本。
更多...
 
boolean setTagPropertyAlternateText (String item_id, String alternate_text) throws com.foxit.sdk.PDFException
 为指定标签项设置标签属性的替代文本。
更多...
 
boolean setTagPropertyID (String item_id, String id) throws com.foxit.sdk.PDFException
 为指定标签项设置标签属性的 ID。
更多...
 
boolean setTagPropertyLanguage (String item_id, String language) throws com.foxit.sdk.PDFException
 为指定标签项设置标签属性的语言。
更多...
 
boolean setTagPropertyTitle (String item_id, String title) throws com.foxit.sdk.PDFException
 为指定标签项设置标签属性的标题。
更多...
 
boolean setTagPropertyType (String item_id, String type) throws com.foxit.sdk.PDFException
 为指定标签项设置标签属性的类型。
更多...
 

静态 Public 属性

static final int e_ArtifactAttachToSideTypeBottom = 4
 人工元素附着边:底部。

 
static final int e_ArtifactAttachToSideTypeLeft = 1
 人工元素附着边:左侧。

 
static final int e_ArtifactAttachToSideTypeNone = 0
 人工元素附着边:无。

 
static final int e_ArtifactAttachToSideTypeRight = 3
 人工元素附着边:右侧。

 
static final int e_ArtifactAttachToSideTypeTop = 2
 人工元素附着边:顶部。

 
static final int e_ArtifactTypeLayout = 2
 人工元素类型:版式人工元素(视觉版式元素)。

 
static final int e_ArtifactTypePage = 0
 人工元素类型:页面级人工元素。

 
static final int e_ArtifactTypePagination = 1
 人工元素类型:与分页相关的人工元素(如页眉/页脚)。

 

详细描述

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

参见
com.foxit.sdk.common.Library

构造及析构函数说明

◆ TagTreeEditor() [1/2]

com.foxit.sdk.addon.accessibility.TagTreeEditor.TagTreeEditor ( PDFDoc  pdf_doc) throws com.foxit.sdk.PDFException

构造函数。

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

◆ TagTreeEditor() [2/2]

com.foxit.sdk.addon.accessibility.TagTreeEditor.TagTreeEditor ( TagTreeEditor  other)

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

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

成员函数说明

◆ addNewTag()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.addNewTag ( String  selected_tag_id,
String  type,
String  title 
) throws com.foxit.sdk.PDFException

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

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

◆ addTagForAnnotation()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.addTagForAnnotation ( boolean  is_tag_annotations,
Annot  annot,
int  page_index,
String  selected_tag_id 
) throws com.foxit.sdk.PDFException

为注释添加标签。

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

◆ changeTagToArtifact()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.changeTagToArtifact ( java.util.ArrayList< java.lang.String >  selected_tag_ids,
int  artifact_type,
int  artifact_to_side 
) throws com.foxit.sdk.PDFException

将标签更改为人工元素。

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

◆ createTagFromSelectionByContent()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.createTagFromSelectionByContent ( java.util.ArrayList< java.lang.String >  selected_content_ids,
String  selected_tag_id 
) throws com.foxit.sdk.PDFException

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

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

◆ createTagFromSelectionByElement()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.createTagFromSelectionByElement ( int  page_index,
String  selected_tag_id 
) throws com.foxit.sdk.PDFException

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

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

◆ createTagFromSelectionByTag()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.createTagFromSelectionByTag ( java.util.ArrayList< java.lang.String >  selected_tag_ids,
String  last_selected_tag_id 
) throws com.foxit.sdk.PDFException

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

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

◆ createTagFromSelectionByText()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.createTagFromSelectionByText ( int  page_index,
RectFArray  selected_text_rects,
String  selected_tag_id 
) throws com.foxit.sdk.PDFException

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

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

◆ delete()

synchronized void com.foxit.sdk.addon.accessibility.TagTreeEditor.delete ( )

直接清除C++相关资源。

返回
无。
注解
一旦这个接口被调用,这个对象将不能再被使用。

重载 com.foxit.sdk.common.Base .

◆ deleteEmptyTags()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.deleteEmptyTags ( java.util.ArrayList< java.lang.String >  selected_tag_ids) throws com.foxit.sdk.PDFException

从标签树中删除空标签。

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

◆ deleteTags()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.deleteTags ( java.util.ArrayList< java.lang.String >  selected_tag_ids) throws com.foxit.sdk.PDFException

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

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

◆ findTagFromSelection()

java.util.ArrayList< java.lang.String > com.foxit.sdk.addon.accessibility.TagTreeEditor.findTagFromSelection ( java.util.ArrayList< java.lang.String >  selected_tag_ids) throws com.foxit.sdk.PDFException

根据选中内容查找标签。

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

◆ getAllContents()

String com.foxit.sdk.addon.accessibility.TagTreeEditor.getAllContents ( String  selected_tag_id) throws com.foxit.sdk.PDFException

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

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

◆ getContentTreeItemIDsByTagItemID()

java.util.ArrayList< java.lang.String > com.foxit.sdk.addon.accessibility.TagTreeEditor.getContentTreeItemIDsByTagItemID ( String  selected_tag_id) throws com.foxit.sdk.PDFException

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

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

◆ getTagPropertyByID()

TagProperty com.foxit.sdk.addon.accessibility.TagTreeEditor.getTagPropertyByID ( String  item_id) throws com.foxit.sdk.PDFException

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

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

◆ getTagTree()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.getTagTree ( ) throws com.foxit.sdk.PDFException

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

返回
标签树项数组。

◆ getTagTreeContextMenuItems()

TagTreeMenuItemDataArray com.foxit.sdk.addon.accessibility.TagTreeEditor.getTagTreeContextMenuItems ( TagTreeMenuInputData  input_data) throws com.foxit.sdk.PDFException

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

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

◆ isEmpty()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.isEmpty ( )

检查当前对象是否为空。

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

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

◆ moveTags()

TagTreeItemArray com.foxit.sdk.addon.accessibility.TagTreeEditor.moveTags ( java.util.ArrayList< java.lang.String >  source_tag_ids,
String  dest_tag_id,
boolean  is_moved_as_child 
) throws com.foxit.sdk.PDFException

在标签树中移动标签。

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

◆ setDocAsTaggedPDF()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setDocAsTaggedPDF ( ) throws com.foxit.sdk.PDFException

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

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

◆ setTagPropertyActualText()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setTagPropertyActualText ( String  item_id,
String  actual_text 
) throws com.foxit.sdk.PDFException

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

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

◆ setTagPropertyAlternateText()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setTagPropertyAlternateText ( String  item_id,
String  alternate_text 
) throws com.foxit.sdk.PDFException

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

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

◆ setTagPropertyID()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setTagPropertyID ( String  item_id,
String  id 
) throws com.foxit.sdk.PDFException

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

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

◆ setTagPropertyLanguage()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setTagPropertyLanguage ( String  item_id,
String  language 
) throws com.foxit.sdk.PDFException

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

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

◆ setTagPropertyTitle()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setTagPropertyTitle ( String  item_id,
String  title 
) throws com.foxit.sdk.PDFException

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

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

◆ setTagPropertyType()

boolean com.foxit.sdk.addon.accessibility.TagTreeEditor.setTagPropertyType ( String  item_id,
String  type 
) throws com.foxit.sdk.PDFException

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

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