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

Public 成员函数

 TaggedPDF (const foxit::pdf::PDFDoc &doc)
 构造函数。 更多...
 
 TaggedPDF (const TaggedPDF &other)
 带另一个标记PDF对象的构造函数。 更多...
 
 ~TaggedPDF ()
 析构函数。
 
WString GetFigureAlternateText (int figure_index)
 获取图形的替代文本。 更多...
 
int GetFigureCount ()
 获取标记文档中图形的数量,不包括装饰性图形。 更多...
 
int GetFigurePageIndex (int figure_index)
 根据图形索引获取图形页面索引。 更多...
 
RectF GetFigureRect (int figure_index)
 获取图形的矩形区域。 更多...
 
bool IsEmpty () const
 检查当前对象是否为空。 更多...
 
bool operator!= (const TaggedPDF &other) const
 不相等操作符。 更多...
 
TaggedPDFoperator= (const TaggedPDF &other)
 赋值操作符。 更多...
 
bool operator== (const TaggedPDF &other) const
 相等操作符。 更多...
 
bool SetAsDecorativeFigure (int figure_index)
 装饰图形。装饰性图形不能设置替代文本。 更多...
 
void SetCallback (TaggedPDFCallback *callback)
 为标记PDF设置回调对象。 更多...
 
void SetFigureAlternateText (int figure_index, const wchar_t *alternate_text)
 设置图形替代文本。 更多...
 
common::Progressive StartTagDocument (common::PauseCallback *pause=0)
 使用指定的标记设置开始自动标记给定的PDF文档。 更多...
 
- Public 成员函数 继承自 foxit::Base
FS_HANDLE Handle () const
 获取当前对象的句柄。 更多...
 

详细描述

此类表示标记PDF文档的设置。标记PDF意味着这里仅针对PDF结构的标记信息。 在使用此模块中的任何类或方法之前,请确保Foxit PDF SDK已通过 common::Library::Initialize函数使用包含"Accessibility"模块的密钥 成功初始化。

参见
common::Library

构造及析构函数说明

◆ TaggedPDF() [1/2]

foxit::addon::accessibility::TaggedPDF::TaggedPDF ( const foxit::pdf::PDFDoc doc)

构造函数。

参数
[in]doc要标记的有效PDF文档对象。

此构造函数用于构造具有默认设置的标记PDF对象。

◆ TaggedPDF() [2/2]

foxit::addon::accessibility::TaggedPDF::TaggedPDF ( const TaggedPDF other)

带另一个标记PDF对象的构造函数。

参数
[in]other另一个标记PDF对象。

成员函数说明

◆ GetFigureAlternateText()

WString foxit::addon::accessibility::TaggedPDF::GetFigureAlternateText ( int  figure_index)

获取图形的替代文本。

替代文本是人类可读的文本,可以通过为图像、公式或其他不能自然转换为文本的项目 提供替代文本来增强PDF文档。 此函数仅用于标记PDF文档。请调用函数 pdf::PDFDoc::IsTaggedPDF检查当前PDF文档是否 是标记PDF文档。

参数
[in]figure_index图形的索引。有效范围:从0到(count-1)。 count由函数TaggedPDF::GetFigureCount返回。
返回
替代描述文本。

◆ GetFigureCount()

int foxit::addon::accessibility::TaggedPDF::GetFigureCount ( )

获取标记文档中图形的数量,不包括装饰性图形。

此函数仅用于标记PDF文档。请调用函数 pdf::PDFDoc::IsTaggedPDF检查当前PDF文档是否 是标记PDF文档。

返回
图形的数量。

◆ GetFigurePageIndex()

int foxit::addon::accessibility::TaggedPDF::GetFigurePageIndex ( int  figure_index)

根据图形索引获取图形页面索引。

此函数仅用于标记PDF文档。请调用函数 pdf::PDFDoc::IsTaggedPDF检查当前PDF文档是否 是标记PDF文档。

参数
[in]figure_index图形的索引。有效范围:从0到(count-1)。 count由函数TaggedPDF::GetFigureCount返回。
返回
页面索引。有效值从0开始。如果出现任何错误,此函数将返回-1。

◆ GetFigureRect()

RectF foxit::addon::accessibility::TaggedPDF::GetFigureRect ( int  figure_index)

获取图形的矩形区域。

此函数仅用于标记PDF文档。请调用函数 pdf::PDFDoc::IsTaggedPDF检查当前PDF文档是否 是标记PDF文档。

参数
[in]figure_index图形的索引。有效范围:从0到(count-1)。 count由函数TaggedPDF::GetFigureCount返回。
返回
图形矩形区域。如果出现任何错误,此函数将返回空矩形。

◆ IsEmpty()

bool foxit::addon::accessibility::TaggedPDF::IsEmpty ( ) const

检查当前对象是否为空。

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

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

◆ operator!=()

bool foxit::addon::accessibility::TaggedPDF::operator!= ( const TaggedPDF other) const

不相等操作符。

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

◆ operator=()

TaggedPDF& foxit::addon::accessibility::TaggedPDF::operator= ( const TaggedPDF other)

赋值操作符。

参数
[in]other另一个标记PDF对象,其值将被赋给当前对象。
返回
当前对象自身的引用。

◆ operator==()

bool foxit::addon::accessibility::TaggedPDF::operator== ( const TaggedPDF other) const

相等操作符。

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

◆ SetAsDecorativeFigure()

bool foxit::addon::accessibility::TaggedPDF::SetAsDecorativeFigure ( int  figure_index)

装饰图形。装饰性图形不能设置替代文本。

此函数仅用于标记PDF文档。请调用函数 pdf::PDFDoc::IsTaggedPDF检查当前PDF文档是否 是标记PDF文档。

参数
[in]figure_index图形的索引。有效范围:从0到(count-1)。 count由函数TaggedPDF::GetFigureCount返回。
返回
true表示装饰图形成功,false表示不成功。

◆ SetCallback()

void foxit::addon::accessibility::TaggedPDF::SetCallback ( TaggedPDFCallback callback)

为标记PDF设置回调对象。

如果不调用此函数,意味着不会使用回调。

参数
[in]callback由用户实现的TaggedPDFCallback对象。 用户可以通过此回调在标记PDF文档期间更改一些信息/数据。 请确保回调对象在当前标记PDF对象的生命周期结束之前保持有效。
如果此值为NULL,意味着使用默认信息/数据。
返回
无。

◆ SetFigureAlternateText()

void foxit::addon::accessibility::TaggedPDF::SetFigureAlternateText ( int  figure_index,
const wchar_t *  alternate_text 
)

设置图形替代文本。

替代文本是人类可读的文本,可以通过为图像、公式或其他不能自然转换为文本的项目 提供替代文本来增强PDF文档。 此函数仅用于标记PDF文档。请调用函数 pdf::PDFDoc::IsTaggedPDF检查当前PDF文档是否 是标记PDF文档。

参数
[in]figure_index图形的索引。有效范围:从0到(count-1)。 count由函数TaggedPDF::GetFigureCount返回。
[in]alternate_text替代描述文本。
返回
无。

◆ StartTagDocument()

common::Progressive foxit::addon::accessibility::TaggedPDF::StartTagDocument ( common::PauseCallback pause = 0)

使用指定的标记设置开始自动标记给定的PDF文档。

如果用户希望在标记文档过程中获取特定的标记结果,请参考函数 TaggedPDF::SetCallback关于回调函数 TaggedPDFCallback::Report

参数
[in]pause暂停对象,决定自动标记过程是否需要暂停。 这可以是NULL,意味着在标记过程中不暂停。 如果不是NULL,它应该是用户实现的有效暂停对象。 默认值:NULL
返回
渐进对象。请通过函数common::Progressive::GetRateOfProgress 检查当前进度的比率。如果比率还不是100,调用函数 common::Progressive::Continue继续进度直到进度完成。