foxit::addon::conversion::pdf2office::PDF2Office类 参考

类 foxit::addon::conversion::pdf2office::PDF2Office 继承关系图:

静态 Public 成员函数
static String	GetVersion ()
	获取Foxit PDF转换SDK的版本。 更多...
static void	Initialize (const wchar_t *library_path, const wchar_t *fx_engine_path=L"")
	初始化Foxit PDF转换。 更多...
static void	Release ()
	释放Foxit PDF转换分配的所有资源。 更多...
static bool	SetConvertCheckCallback (ConvertCheckCallback *convert_check_callback)
	设置检查PDF到Office转换条件的回调对象。 更多...
static common::Progressive	StartConvertToExcel (const wchar_t *src_pdf_path, const wchar_t *src_pdf_password, const wchar_t *saved_excel_file_path, const PDF2OfficeSettingData &setting_data, ConvertCallback *convert_callback=0)
	开始将PDF文件转换为Excel格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。 更多...
static common::Progressive	StartConvertToExcel (common::file::ReaderCallback *src_pdf_reader, const wchar_t *src_pdf_password, common::file::StreamCallback *saved_excel_file_stream, const PDF2OfficeSettingData &setting_data, ConvertCallback *convert_callback=0)
	开始将PDF文件转换为Excel格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。 更多...
static common::Progressive	StartConvertToPowerPoint (const wchar_t *src_pdf_path, const wchar_t *src_pdf_password, const wchar_t *saved_ppt_file_path, const PDF2OfficeSettingData &setting_data, ConvertCallback *convert_callback=0)
	开始将PDF文件转换为PowerPoint格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。 更多...
static common::Progressive	StartConvertToPowerPoint (common::file::ReaderCallback *src_pdf_reader, const wchar_t *src_pdf_password, common::file::StreamCallback *saved_ppt_file_stream, const PDF2OfficeSettingData &setting_data, ConvertCallback *convert_callback=0)
	开始将PDF文件转换为PowerPoint格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。 更多...
static common::Progressive	StartConvertToWord (const wchar_t *src_pdf_path, const wchar_t *src_pdf_password, const wchar_t *saved_word_file_path, const PDF2OfficeSettingData &setting_data, ConvertCallback *convert_callback=0)
	开始将PDF文件转换为Word格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。 更多...
static common::Progressive	StartConvertToWord (common::file::ReaderCallback *src_pdf_reader, const wchar_t *src_pdf_password, common::file::StreamCallback *saved_word_file_stream, const PDF2OfficeSettingData &setting_data, ConvertCallback *convert_callback=0)
	开始将PDF文件转换为Word格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。 更多...

额外继承的成员函数
Public 成员函数 继承自 foxit::Base
FS_HANDLE	Handle () const
	获取当前对象的句柄。 更多...

详细描述

此类可用于将PDF文件转换为Office（Word、Excel或PowerPoint）格式文件。 在使用"转换"模块之前，请确保Foxit PDF转换SDK包中名为"res"和"lib"的资源文件夹有效。 在使用此模块中的方法之前，请确保Foxit PDF SDK已通过函数common::Library::Initialize 使用包含"PDF2Office"模块的密钥成功初始化。

参见

common::Library

成员函数说明

GetVersion()

static String foxit::addon::conversion::pdf2office::PDF2Office::GetVersion ( )

static

获取Foxit PDF转换SDK的版本。

此函数应在函数PDF2Office::Initialize成功调用后调用。

返回

包含Foxit PDF转换SDK版本信息的字符串。

Initialize()

static void foxit::addon::conversion::pdf2office::PDF2Office::Initialize ( const wchar_t *  library_path, const wchar_t *  fx_engine_path = L""  )

static

初始化Foxit PDF转换。

在"PDF2Office"模块的生命周期内，此函数只能调用一次， 并且应在"PDF2Office"模块中任何其他函数被调用之前首先调用。

参数

[in]	library_path	Foxit PDF转换SDK库的路径。这不应该是空字符串。
[in]	fx_engine_path	Foxit PDF转换引擎的路径。可以是空字符串。如果参数 为空，PDF转换SDK库将直接调用进行PDF到Office转换， 否则Foxit PDF转换SDK库将通过Foxit PDF转换引擎调用进行PDF到Office转换。

返回

无。

注解

如果在函数common::Library::Initialize中使用的许可证信息中未定义模块"PDF2Office"， 这意味着用户没有使用PDF2Office相关函数的权限， 此函数将抛出异常foxit::e_ErrNoPDF2OfficeModuleRight。

Release()

static void foxit::addon::conversion::pdf2office::PDF2Office::Release ( )

static

释放Foxit PDF转换分配的所有资源。

当用户不使用"pdf2office"模块时，应调用此函数释放库分配的所有内存块。

返回

无。

SetConvertCheckCallback()

static bool foxit::addon::conversion::pdf2office::PDF2Office::SetConvertCheckCallback ( ConvertCheckCallback *  convert_check_callback )

static

设置检查PDF到Office转换条件的回调对象。

此方法允许您指定一个自定义转换检查回调，当转换PDF文档所需的权限不满足时， 将调用该回调来评估是否应继续从PDF到Office的转换，基于用户定义的逻辑。

参数

[in]

convert_check_callback

基于回调类ConvertCheckCallback实现的自定义转换检查回调。 如果这是NULL，自定义转换检查回调将被删除，改为使用默认转换检查。

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCheckCallback将不起作用， 它将使用内部ConvertCheckcallbacks来允许转换。

返回

true表示成功，而false表示失败。

StartConvertToExcel() [1/2]

static common::Progressive foxit::addon::conversion::pdf2office::PDF2Office::StartConvertToExcel ( const wchar_t *  src_pdf_path, const wchar_t *  src_pdf_password, const wchar_t *  saved_excel_file_path, const PDF2OfficeSettingData &  setting_data, ConvertCallback *  convert_callback = 0  )

static

开始将PDF文件转换为Excel格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。

目前仅支持转换为XLSX格式文件。

参数

[in]	src_pdf_path	PDF文件的路径。这不应该是空字符串。
[in]	src_pdf_password	输入PDF文件的密码。如果文件不需要密码，请传递空字符串。
[in]	saved_excel_file_path	作为转换结果保存的Excel格式文件的路径。这不应该是空字符串。 如果保存的Excel格式文件的后缀名不是"xlsx"，将在原文件名后添加新的后缀"xlsx"。
[in]	setting_data	用于转换的设置数据。如果PDF2OfficeSettingData对象的参数page_range 为空，这意味着将PDF文件的每一页都转换为Excel格式文件。
[in]	convert_callback	由用户实现的conversion::pdf2office::ConvertCallback对象， 用于在转换过程中暂停和通知转换进度。 这可以是NULL，意味着不暂停和通知转换进度。 如果这不是NULL，它应该是由用户实现的有效conversion::pdf2office::ConvertCallback对象。 默认值：NULL。

返回

一个渐进对象。请通过函数common::Progressive::GetRateOfProgress检查当前进度的速率。 common::Progressive::GetRateOfProgress. If the rate is not 100 yet, call function common::Progressive::Continue to continue the progress until the progress is finished.

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

StartConvertToExcel() [2/2]

static common::Progressive foxit::addon::conversion::pdf2office::PDF2Office::StartConvertToExcel ( common::file::ReaderCallback *  src_pdf_reader, const wchar_t *  src_pdf_password, common::file::StreamCallback *  saved_excel_file_stream, const PDF2OfficeSettingData &  setting_data, ConvertCallback *  convert_callback = 0  )

static

开始将PDF文件转换为Excel格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。

目前仅支持转换为XLSX格式文件。

参数

[in]	src_pdf_reader	由用户实现的ReaderCallback对象， 用于加载PDF文档。它不应该是NULL。
[in]	src_pdf_password	输入PDF文件的密码。如果文件不需要密码，请传递空字符串。
[in]	saved_excel_file_stream	由用户实现的foxit::common::file::StreamCallback对象， 用于读取转换后Excel格式文件的内容。它不应该是NULL。
[in]	setting_data	用于转换的设置数据。如果PDF2OfficeSettingData对象的参数page_range 为空，这意味着将PDF文件的每一页都转换为Excel格式文件。
[in]	convert_callback	由用户实现的conversion::pdf2office::ConvertCallback对象， 用于在转换过程中暂停和通知转换进度。 这可以是NULL，意味着不暂停和通知转换进度。 如果这不是NULL，它应该是由用户实现的有效conversion::pdf2office::ConvertCallback对象。 默认值：NULL。

返回

一个渐进对象。请通过函数common::Progressive::GetRateOfProgress检查当前进度的速率。 如果速率还不是100，调用函数common::Progressive::Continue继续进度直到进度完成。

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

StartConvertToPowerPoint() [1/2]

static common::Progressive foxit::addon::conversion::pdf2office::PDF2Office::StartConvertToPowerPoint ( const wchar_t *  src_pdf_path, const wchar_t *  src_pdf_password, const wchar_t *  saved_ppt_file_path, const PDF2OfficeSettingData &  setting_data, ConvertCallback *  convert_callback = 0  )

static

开始将PDF文件转换为PowerPoint格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。

目前仅支持转换为PPTX格式文件。

参数

[in]	src_pdf_path	PDF文件的路径。这不应该是空字符串。
[in]	src_pdf_password	输入PDF文件的密码。如果文件不需要密码，请传递空字符串。
[in]	saved_ppt_file_path	作为转换结果保存的PowerPoint格式文件的路径。这不应该是空字符串。 如果保存的PowerPoint格式文件的后缀名不是"pptx"，将在原文件名后添加新的后缀"pptx"。
[in]	setting_data	用于转换的设置数据。如果PDF2OfficeSettingData对象的参数page_range 为空，这意味着将PDF文件的每一页都转换为PowerPoint格式文件。
[in]	convert_callback	由用户实现的conversion::pdf2office::ConvertCallback对象， 用于在转换过程中暂停和通知转换进度。 这可以是NULL，意味着不暂停和通知转换进度。 如果这不是NULL，它应该是由用户实现的有效conversion::pdf2office::ConvertCallback对象。 默认值：NULL。

返回

一个渐进对象。请通过函数common::Progressive::GetRateOfProgress检查当前进度的速率。 如果速率还不是100，调用函数common::Progressive::Continue继续进度直到进度完成。

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

StartConvertToPowerPoint() [2/2]

static common::Progressive foxit::addon::conversion::pdf2office::PDF2Office::StartConvertToPowerPoint ( common::file::ReaderCallback *  src_pdf_reader, const wchar_t *  src_pdf_password, common::file::StreamCallback *  saved_ppt_file_stream, const PDF2OfficeSettingData &  setting_data, ConvertCallback *  convert_callback = 0  )

static

开始将PDF文件转换为PowerPoint格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。

目前仅支持转换为PPTX格式文件。

参数

[in]	src_pdf_reader	由用户实现的ReaderCallback对象， 用于加载PDF文档。它不应该是NULL。
[in]	src_pdf_password	输入PDF文件的密码。如果文件不需要密码，请传递空字符串。
[in]	saved_ppt_file_stream	由用户实现的foxit::common::file::StreamCallback对象， 用于读取转换后PowerPoint格式文件的内容。它不应该是NULL。
[in]	setting_data	用于转换的设置数据。如果PDF2OfficeSettingData对象的参数page_range 为空，这意味着将PDF文件的每一页都转换为PowerPoint格式文件。
[in]	convert_callback	由用户实现的conversion::pdf2office::ConvertCallback对象， 用于在转换过程中暂停和通知转换进度。 这可以是NULL，意味着不暂停和通知转换进度。 如果这不是NULL，它应该是由用户实现的有效conversion::pdf2office::ConvertCallback对象。 默认值：NULL。

返回

一个渐进对象。请通过函数common::Progressive::GetRateOfProgress检查当前进度的速率。 如果速率还不是100，调用函数common::Progressive::Continue继续进度直到进度完成。

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

StartConvertToWord() [1/2]

static common::Progressive foxit::addon::conversion::pdf2office::PDF2Office::StartConvertToWord ( const wchar_t *  src_pdf_path, const wchar_t *  src_pdf_password, const wchar_t *  saved_word_file_path, const PDF2OfficeSettingData &  setting_data, ConvertCallback *  convert_callback = 0  )

static

开始将PDF文件转换为Word格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。

目前仅支持转换为DOCX格式文件。

参数

[in]	src_pdf_path	PDF文件的路径。这不应该是空字符串。
[in]	src_pdf_password	输入PDF文件的密码。如果文件不需要密码，请传递空字符串。
[in]	saved_word_file_path	作为转换结果保存的Word格式文件的路径。这不应该是空字符串。 如果保存的Word格式文件的后缀名不是"docx"，将在原文件名后添加新的后缀"docx"。
[in]	setting_data	用于转换的设置数据。如果PDF2OfficeSettingData对象的参数page_range 为空，这意味着将PDF文件的每一页都转换为Word格式文件。
[in]	convert_callback	由用户实现的conversion::pdf2office::ConvertCallback对象， 用于在转换过程中暂停和通知转换进度。 这可以是NULL，意味着不暂停和通知转换进度。 如果这不是NULL，它应该是由用户实现的有效conversion::pdf2office::ConvertCallback对象。 默认值：NULL。

返回

一个渐进对象。请通过函数common::Progressive::GetRateOfProgress检查当前进度的速率。 如果速率还不是100，调用函数common::Progressive::Continue继续进度直到进度完成。

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

StartConvertToWord() [2/2]

static common::Progressive foxit::addon::conversion::pdf2office::PDF2Office::StartConvertToWord ( common::file::ReaderCallback *  src_pdf_reader, const wchar_t *  src_pdf_password, common::file::StreamCallback *  saved_word_file_stream, const PDF2OfficeSettingData &  setting_data, ConvertCallback *  convert_callback = 0  )

static

开始将PDF文件转换为Word格式文件。必须在调用此函数之前调用函数PDF2Office::Initialize。

目前仅支持转换为DOCX格式文件。

参数

[in]	src_pdf_reader	由用户实现的ReaderCallback对象， 用于加载PDF文档。它不应该是NULL。
[in]	src_pdf_password	输入PDF文件的密码。如果文件不需要密码，请传递空字符串。
[in]	saved_word_file_stream	由用户实现的foxit::common::file::StreamCallback对象， 用于读取转换后Word格式文件的内容。它不应该是NULL。
[in]	setting_data	用于转换的设置数据。如果PDF2OfficeSettingData对象的参数page_range 为空，这意味着将PDF文件的每一页都转换为Word格式文件。
[in]	convert_callback	由用户实现的conversion::pdf2office::ConvertCallback对象， 用于在转换过程中暂停和通知转换进度。 这可以是NULL，意味着不暂停和通知转换进度。 如果这不是NULL，它应该是由用户实现的有效conversion::pdf2office::ConvertCallback对象。 默认值：NULL。

返回

一个渐进对象。请通过函数common::Progressive::GetRateOfProgress检查当前进度的速率。 如果速率还不是100，调用函数common::Progressive::Continue继续进度直到进度完成。

注解

当通过函数PDF2Office::Initialize设置Foxit PDF转换引擎时，ConvertCallback将不起作用。