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

Public 类型

enum  StructureType {
  StructureType.e_StructureTypeText = 0, StructureType.e_StructureTypeFigure = 1, StructureType.e_StructureTypeFormfield = 2, StructureType.e_StructureTypeFigureOrCaption = 3,
  StructureType.e_StructureTypeCaption = 4, StructureType.e_StructureTypeH1 = 5, StructureType.e_StructureTypeH2 = 6, StructureType.e_StructureTypeH3 = 7,
  StructureType.e_StructureTypeH4 = 8, StructureType.e_StructureTypeH5 = 9, StructureType.e_StructureTypeH6 = 10, StructureType.e_StructureTypeTable = 11,
  StructureType.e_StructureTypeCell = 12, StructureType.e_StructureTypeFormula = 13, StructureType.e_StructureTypeReference = 14, StructureType.e_StructureTypeNote = 15,
  StructureType.e_StructureTypeBackgroundOrArtifact = 16
}
 阅读顺序结构类型的枚举。 更多...
 
enum  TableSelectResult {
  TableSelectResult.e_TableSelectResultNone = 0, TableSelectResult.e_TableSelectResultNotStarted = 1, TableSelectResult.e_TableSelectResultNotSamePage = 2, TableSelectResult.e_TableSelectResultNoTableExist = 3,
  TableSelectResult.e_TableSelectResultNotInTable = 4
}
 表格选择结果的枚举。 更多...
 

Public 成员函数

 ReadingOrder (PDFDoc pdf_doc)
 构造函数。 更多...
 
 ReadingOrder (ReadingOrder other)
 构造函数,使用另一个阅读顺序对象。 更多...
 
RectFArray AddOrderDataForRect (int page_index, RectF rect)
 根据选中的矩形区域添加顺序数据。 更多...
 
bool ApplyReadingOrder (int page_index, RectFArray selected_rect)
 根据选中的矩形区域,为指定页面应用阅读顺序。 更多...
 
bool CanMoveDataOrder (int page_index, TreeItemInfoArray select_info_array, TreeItemInfo dest_move_item)
 检查数据顺序是否可以移动。 更多...
 
ReadingOrder.TableSelectResult CanSelectTableCellAtPoint (PDFPage page, PointF point)
 检查鼠标在给定点按下时是否可以选择表格单元格。 更多...
 
void ClearPageStructInfo (PDFPage page)
 清除页面结构信息。 更多...
 
int DeleteOrderDataStructInfo (PDFPage page, Int32Array src_order_index_array, bool is_loaded)
 删除顺序数据结构信息。 更多...
 
bool DrawReadingOrderItems (int page_index)
 开始绘制指定页面的阅读顺序项。 更多...
 
bool EndEditTable ()
 结束编辑表格。 更多...
 
bool GenerateTableHeaderIDs ()
 自动生成表格表头 ID。 更多...
 
StringArray GetAllLeafChildrenByContentItemID (ContentTreeItemArray content_tree, string content_item_id)
 根据内容项 ID 获取所有叶子子项。 更多...
 
ContentTreeItemArray GetContentTree ()
 获取内容树。 更多...
 
WStringArray GetCurrentTableHeaderIDs ()
 获取当前表格的所有表头 ID。 更多...
 
TreeItemArray GetReadingOrderTreeItems ()
 获取阅读顺序树项。 更多...
 
TableCellAttributeArray GetSelectedTableCellAttributes ()
 获取选中的表格单元格属性。 更多...
 
string GetTableSummary (PDFPage page)
 获取表格摘要。 更多...
 
bool HasHeaderID (string header_id)
 检查当前表格表头 ID 是否已存在。 更多...
 
bool HasMissingHeaderIDs ()
 检查当前表格是否缺少表头 ID。 更多...
 
bool IsEditingTable ()
 检查是否已开始表格编辑。 更多...
 
bool IsEmpty ()
 检查当前对象是否为空。 更多...
 
int MoveOrderData (int page_index, Int32Array src_order_index_array, int dest_order_index)
 移动数据顺序。 更多...
 
RectFArray RemoveOrderDataForRect (int page_index, RectF rect)
 根据选中的矩形区域移除顺序数据。 更多...
 
bool SelectTableAtPoint (int page_index, PointF point)
 选中页面上指定点处的表格(如果存在)。 更多...
 
ReadingOrder.TableSelectResult SelectTableCellAtPoint (PDFPage page, PointF point, RectFArray region_selected, bool appended)
 鼠标抬起时通过点选择表格单元格。 更多...
 
ReadingOrder.TableSelectResult SelectTableCellAtRect (PDFPage page, RectF rect, RectFArray region_selected, bool appended)
 鼠标抬起时通过矩形区域选择表格单元格。 更多...
 
bool SetOrderTypeForSelectedContent (ReadingOrder.StructureType structure_type)
 根据选中的矩形区域设置顺序类型。 更多...
 
bool SetOrderTypeForSelectedTreeItems (ReadingOrder.StructureType structure_type, TreeItemInfoArray select_info_array)
 根据选中的树项设置顺序类型。 更多...
 
void SetReadingOrderOptions (ReadingOrderOptions options)
 设置阅读顺序选项。 更多...
 
bool SetSelectedTableCellAttributes (TableCellAttribute cell_attribute, bool change_id_enabled, bool need_change_ids)
 设置选中的表格单元格属性。 更多...
 
bool SetTableSummary (PDFPage page, string table_summary)
 设置表格摘要。 更多...
 
bool StartEditTable (PDFPage page)
 开始编辑表格。 更多...
 
bool StartEditTableAtPoint (PDFPage page, PointF point)
 开始编辑页面上指定点处的表格(如果存在)。 更多...
 
void SynchronizeTable ()
 同步表格。 更多...
 

详细描述

此类表示用于 PDF 文档辅助功能阅读顺序操作的阅读顺序。 使用此模块中的任何类或方法之前,请确保已通过带有 "Accessibility" 模块授权的 key 调用 common.Library.Initialize 函数成功初始化 Foxit PDF SDK。

参见
foxit.common.Library

成员枚举类型说明

◆ StructureType

阅读顺序结构类型的枚举。

此枚举的值应单独使用。

枚举值
e_StructureTypeText 

结构类型:文本。

e_StructureTypeFigure 

结构类型:图形。

e_StructureTypeFormfield 

结构类型:表单域。

e_StructureTypeFigureOrCaption 

结构类型:图形或标题。

e_StructureTypeCaption 

结构类型:标题。

e_StructureTypeH1 

结构类型:H1。

e_StructureTypeH2 

结构类型:H2。

e_StructureTypeH3 

结构类型:H3。

e_StructureTypeH4 

结构类型:H4。

e_StructureTypeH5 

结构类型:H5。

e_StructureTypeH6 

结构类型:H6。

e_StructureTypeTable 

结构类型:表格。

e_StructureTypeCell 

结构类型:单元格。

e_StructureTypeFormula 

结构类型:公式。

e_StructureTypeReference 

结构类型:引用。

e_StructureTypeNote 

结构类型:注释。

e_StructureTypeBackgroundOrArtifact 

结构类型:背景或 Artifact。

◆ TableSelectResult

表格选择结果的枚举。

此枚举的值应单独使用。

枚举值
e_TableSelectResultNone 

表格选择结果:无。

e_TableSelectResultNotStarted 

表格选择结果:未开始。

e_TableSelectResultNotSamePage 

表格选择结果:不在同一页。

e_TableSelectResultNoTableExist 

表格选择结果:不存在表格。

e_TableSelectResultNotInTable 

表格选择结果:不在表格中。

构造及析构函数说明

◆ ReadingOrder() [1/2]

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

构造函数。

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

◆ ReadingOrder() [2/2]

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

构造函数,使用另一个阅读顺序对象。

参数
[in]other另一个阅读顺序对象。

成员函数说明

◆ AddOrderDataForRect()

RectFArray foxit.addon.accessibility.ReadingOrder.AddOrderDataForRect ( int  page_index,
RectF  rect 
)
inline

根据选中的矩形区域添加顺序数据。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]rect选中的矩形区域。
返回
矩形数组。

◆ ApplyReadingOrder()

bool foxit.addon.accessibility.ReadingOrder.ApplyReadingOrder ( int  page_index,
RectFArray  selected_rect 
)
inline

根据选中的矩形区域,为指定页面应用阅读顺序。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]selected_rect用于应用阅读顺序的选中矩形区域数组。
返回
true 表示成功,false 表示不成功。

◆ CanMoveDataOrder()

bool foxit.addon.accessibility.ReadingOrder.CanMoveDataOrder ( int  page_index,
TreeItemInfoArray  select_info_array,
TreeItemInfo  dest_move_item 
)
inline

检查数据顺序是否可以移动。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]select_info_array选中信息数组。
[in]dest_move_item目标移动项。
返回
true 表示数据顺序可以移动,false 表示不可以移动。

◆ CanSelectTableCellAtPoint()

ReadingOrder.TableSelectResult foxit.addon.accessibility.ReadingOrder.CanSelectTableCellAtPoint ( PDFPage  page,
PointF  point 
)
inline

检查鼠标在给定点按下时是否可以选择表格单元格。

参数
[in]pagePDF 页面对象。
[in]point点,采用 PDF 坐标系(PDFPage)。
返回
表格选择结果。请参见从 foxit.addon.accessibility.ReadingOrder.TableSelectResult.e_TableSelectResultNone 开始的值。

◆ ClearPageStructInfo()

void foxit.addon.accessibility.ReadingOrder.ClearPageStructInfo ( PDFPage  page)
inline

清除页面结构信息。

参数
[in]pagePDF 页面对象。
返回
无。

◆ DeleteOrderDataStructInfo()

int foxit.addon.accessibility.ReadingOrder.DeleteOrderDataStructInfo ( PDFPage  page,
Int32Array  src_order_index_array,
bool  is_loaded 
)
inline

删除顺序数据结构信息。

参数
[in]pagePDF 页面对象。
[in]src_order_index_array源顺序索引数组。
[in]is_loaded页面是否已加载。
返回
已删除的数量。

◆ DrawReadingOrderItems()

bool foxit.addon.accessibility.ReadingOrder.DrawReadingOrderItems ( int  page_index)
inline

开始绘制指定页面的阅读顺序项。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
返回
true 表示成功,false 表示不成功。

◆ EndEditTable()

bool foxit.addon.accessibility.ReadingOrder.EndEditTable ( )
inline

结束编辑表格。

返回
true 表示成功,false 表示不成功。

◆ GenerateTableHeaderIDs()

bool foxit.addon.accessibility.ReadingOrder.GenerateTableHeaderIDs ( )
inline

自动生成表格表头 ID。

返回
true 表示成功,false 表示不成功。

◆ GetAllLeafChildrenByContentItemID()

StringArray foxit.addon.accessibility.ReadingOrder.GetAllLeafChildrenByContentItemID ( ContentTreeItemArray  content_tree,
string  content_item_id 
)
inline

根据内容项 ID 获取所有叶子子项。

参数
[in]content_tree内容树。
[in]content_item_id内容项 ID。
返回
叶子子项 ID 数组。

◆ GetContentTree()

ContentTreeItemArray foxit.addon.accessibility.ReadingOrder.GetContentTree ( )
inline

获取内容树。

返回
内容树项数组。

◆ GetCurrentTableHeaderIDs()

WStringArray foxit.addon.accessibility.ReadingOrder.GetCurrentTableHeaderIDs ( )
inline

获取当前表格的所有表头 ID。

返回
表头 ID 数组。

◆ GetReadingOrderTreeItems()

TreeItemArray foxit.addon.accessibility.ReadingOrder.GetReadingOrderTreeItems ( )
inline

获取阅读顺序树项。

返回
阅读顺序树项数组。

◆ GetSelectedTableCellAttributes()

TableCellAttributeArray foxit.addon.accessibility.ReadingOrder.GetSelectedTableCellAttributes ( )
inline

获取选中的表格单元格属性。

返回
单元格属性对象数组。

◆ GetTableSummary()

string foxit.addon.accessibility.ReadingOrder.GetTableSummary ( PDFPage  page)
inline

获取表格摘要。

参数
[in]pagePDF 页面对象。
返回
表格摘要文本。

◆ HasHeaderID()

bool foxit.addon.accessibility.ReadingOrder.HasHeaderID ( string  header_id)
inline

检查当前表格表头 ID 是否已存在。

参数
[in]header_id要检查的表头 ID。
返回
true 表示该表头 ID 已存在,false 表示不存在。

◆ HasMissingHeaderIDs()

bool foxit.addon.accessibility.ReadingOrder.HasMissingHeaderIDs ( )
inline

检查当前表格是否缺少表头 ID。

返回
true 表示当前表格缺少表头 ID,false 表示未缺少。

◆ IsEditingTable()

bool foxit.addon.accessibility.ReadingOrder.IsEditingTable ( )
inline

检查是否已开始表格编辑。

返回
true 表示已开始表格编辑,false 表示未开始。

◆ IsEmpty()

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

检查当前对象是否为空。

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

◆ MoveOrderData()

int foxit.addon.accessibility.ReadingOrder.MoveOrderData ( int  page_index,
Int32Array  src_order_index_array,
int  dest_order_index 
)
inline

移动数据顺序。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]src_order_index_array源顺序索引数组。
[in]dest_order_index目标顺序索引。
返回
已移动的数量。

◆ RemoveOrderDataForRect()

RectFArray foxit.addon.accessibility.ReadingOrder.RemoveOrderDataForRect ( int  page_index,
RectF  rect 
)
inline

根据选中的矩形区域移除顺序数据。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]rect选中的矩形区域。
返回
矩形数组。

◆ SelectTableAtPoint()

bool foxit.addon.accessibility.ReadingOrder.SelectTableAtPoint ( int  page_index,
PointF  point 
)
inline

选中页面上指定点处的表格(如果存在)。

参数
[in]page_index页面索引。有效取值范围为 0 到 (count - 1),其中 count 为函数 pdf.PDFDoc.GetPageCount 返回的页面总数。
[in]point用于定位表格的点,使用 PDF 页面坐标系。
返回
true 表示在指定点处找到并选中了表格,false 表示未找到。

◆ SelectTableCellAtPoint()

ReadingOrder.TableSelectResult foxit.addon.accessibility.ReadingOrder.SelectTableCellAtPoint ( PDFPage  page,
PointF  point,
RectFArray  region_selected,
bool  appended 
)
inline

鼠标抬起时通过点选择表格单元格。

参数
[in]pagePDF 页面对象。
[in]point点。
[out]region_selected选中区域数组。
[in]appended是否追加选择。
返回
表格选择结果。请参见从 foxit.addon.accessibility.ReadingOrder.TableSelectResult.e_TableSelectResultNone 开始的值。

◆ SelectTableCellAtRect()

ReadingOrder.TableSelectResult foxit.addon.accessibility.ReadingOrder.SelectTableCellAtRect ( PDFPage  page,
RectF  rect,
RectFArray  region_selected,
bool  appended 
)
inline

鼠标抬起时通过矩形区域选择表格单元格。

参数
[in]pagePDF 页面对象。
[in]rect矩形区域。
[out]region_selected选中区域数组。
[in]appended是否追加选择。
返回
表格选择结果。请参见从 foxit.addon.accessibility.ReadingOrder.TableSelectResult.e_TableSelectResultNone 开始的值。

◆ SetOrderTypeForSelectedContent()

bool foxit.addon.accessibility.ReadingOrder.SetOrderTypeForSelectedContent ( ReadingOrder.StructureType  structure_type)
inline

根据选中的矩形区域设置顺序类型。

参数
[in]structure_type结构类型。请参见从 开始的值, 该值应为其中之一。
返回
true 表示成功,false 表示不成功。

◆ SetOrderTypeForSelectedTreeItems()

bool foxit.addon.accessibility.ReadingOrder.SetOrderTypeForSelectedTreeItems ( ReadingOrder.StructureType  structure_type,
TreeItemInfoArray  select_info_array 
)
inline

根据选中的树项设置顺序类型。

参数
[in]structure_type结构类型。请参见 。
[in]select_info_array选中信息数组。
返回
true 表示成功,false 表示不成功。

◆ SetReadingOrderOptions()

void foxit.addon.accessibility.ReadingOrder.SetReadingOrderOptions ( ReadingOrderOptions  options)
inline

设置阅读顺序选项。

参数
[in]options阅读顺序选项。请参见 ReadingOrderOptions 。
返回
无。

◆ SetSelectedTableCellAttributes()

bool foxit.addon.accessibility.ReadingOrder.SetSelectedTableCellAttributes ( TableCellAttribute  cell_attribute,
bool  change_id_enabled,
bool  need_change_ids 
)
inline

设置选中的表格单元格属性。

参数
[in]cell_attribute要设置的单元格属性。
[in]change_id_enabled是否允许更改 ID。
[in]need_change_ids是否更改 ID。
返回
true 表示成功,false 表示不成功。

◆ SetTableSummary()

bool foxit.addon.accessibility.ReadingOrder.SetTableSummary ( PDFPage  page,
string  table_summary 
)
inline

设置表格摘要。

参数
[in]pagePDF 页面对象。
[in]table_summary表格摘要文本。
返回
true 表示成功,false 表示不成功。

◆ StartEditTable()

bool foxit.addon.accessibility.ReadingOrder.StartEditTable ( PDFPage  page)
inline

开始编辑表格。

参数
[in]pagePDF 页面对象。
返回
true 表示成功,false 表示不成功。

◆ StartEditTableAtPoint()

bool foxit.addon.accessibility.ReadingOrder.StartEditTableAtPoint ( PDFPage  page,
PointF  point 
)
inline

开始编辑页面上指定点处的表格(如果存在)。

参数
[in]pagePDF 页面对象。
[in]point用于定位待编辑表格的点,采用 PDF 坐标系(PDFPage)。
返回
true 表示在指定点处找到表格并成功开始编辑,false 表示未找到或开始编辑失败。

◆ SynchronizeTable()

void foxit.addon.accessibility.ReadingOrder.SynchronizeTable ( )
inline

同步表格。

返回
无。