Foxit PDF SDK

Public 成员函数 | 静态 Public 成员函数 | 所有成员列表
com.foxit.sdk.addon.conversion.pdf2office.PDF2Office类 参考
类 com.foxit.sdk.addon.conversion.pdf2office.PDF2Office 继承关系图:

## Public 成员函数
synchronized void | delete ()
| 直接清除C++相关资源。 更多...
Public 成员函数 继承自 com.foxit.sdk.common.Base
synchronized void | delete ()
| 直接清除C++相关资源。 更多...

## 静态 Public 成员函数
static String | getVersion () throws com.foxit.sdk.PDFException
| 获取Foxit PDF转换SDK的版本。 更多...
static void | initialize (String library_path, String fx_engine_path) throws com.foxit.sdk.PDFException
| 初始化Foxit PDF转换。 更多...
static void | release () throws com.foxit.sdk.PDFException
| 释放Foxit PDF转换分配的所有资源。 更多...
static boolean | setConvertCheckCallback (ConvertCheckCallback convert_check_callback)
| 设置检查PDF到Office转换条件的回调对象。 更多...
static Progressive | startConvertToExcel (String src_pdf_path, String src_pdf_password, String saved_excel_file_path, PDF2OfficeSettingData setting_data, ConvertCallback convert_callback) throws com.foxit.sdk.PDFException
| 开始将PDF文件转换为Excel格式文件。必须在调用此函数之前调用函数PDF2Office.initialize 。 更多...
static Progressive | startConvertToExcel (FileReaderCallback src_pdf_reader, String src_pdf_password, StreamCallback saved_excel_file_stream, PDF2OfficeSettingData setting_data, ConvertCallback convert_callback) throws com.foxit.sdk.PDFException
| 开始将PDF文件转换为Excel格式文件。必须在调用此函数之前调用函数PDF2Office.initialize 。 更多...
static Progressive | startConvertToPowerPoint (String src_pdf_path, String src_pdf_password, String saved_ppt_file_path, PDF2OfficeSettingData setting_data, ConvertCallback convert_callback) throws com.foxit.sdk.PDFException
| 开始将PDF文件转换为PowerPoint格式文件。必须在调用此函数之前调用函数PDF2Office.initialize 。 更多...
static Progressive | startConvertToPowerPoint (FileReaderCallback src_pdf_reader, String src_pdf_password, StreamCallback saved_ppt_file_stream, PDF2OfficeSettingData setting_data, ConvertCallback convert_callback) throws com.foxit.sdk.PDFException
| 开始将PDF文件转换为PowerPoint格式文件。必须在调用此函数之前调用函数PDF2Office.initialize 。 更多...
static Progressive | startConvertToWord (String src_pdf_path, String src_pdf_password, String saved_word_file_path, PDF2OfficeSettingData setting_data, ConvertCallback convert_callback) throws com.foxit.sdk.PDFException
| 开始将PDF文件转换为Word格式文件。必须在调用此函数之前调用函数PDF2Office.initialize 。 更多...
static Progressive | startConvertToWord (FileReaderCallback src_pdf_reader, String src_pdf_password, StreamCallback saved_word_file_stream, PDF2OfficeSettingData setting_data, ConvertCallback convert_callback) throws com.foxit.sdk.PDFException
| 开始将PDF文件转换为Word格式文件。必须在调用此函数之前调用函数PDF2Office.initialize 。 更多...

## 详细描述

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

参见
  com.foxit.sdk.common.Library

## 成员函数说明

## ◆ delete()

synchronized void com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.delete | ( |  | ) |

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

返回
  无。

注解
  一旦这个接口被调用，这个对象将不能再被使用。

## ◆ getVersion()

static String com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.getVersion | ( |  | ) | throws com.foxit.sdk.PDFException
| static

获取Foxit PDF转换SDK的版本。

此函数应在函数PDF2Office.initialize 成功调用后调用。

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

## ◆ initialize()

static void com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.initialize | ( | String | library_path,
|  | String | fx_engine_path
| ) |  | throws com.foxit.sdk.PDFException
| 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相关函数的权限， 此函数将抛出异常com.foxit.sdk.common.Constants.e_ErrNoPDF2OfficeModuleRight 。

## ◆ release()

static void com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.release | ( |  | ) | throws com.foxit.sdk.PDFException
| static

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

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

返回
  无。

## ◆ setConvertCheckCallback()

static boolean com.foxit.sdk.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 Progressive com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.startConvertToExcel | ( | String | src_pdf_path,
|  | String | src_pdf_password,
|  | String | saved_excel_file_path,
|  | PDF2OfficeSettingData | setting_data,
|  | ConvertCallback | convert_callback
| ) |  | throws com.foxit.sdk.PDFException
| 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 | 由用户实现的com.foxit.sdk.addon.conversion.pdf2office.ConvertCallback 对象， 用于在转换过程中暂停和通知转换进度。 这可以是null，意味着不暂停和通知转换进度。 如果这不是null，它应该是由用户实现的有效com.foxit.sdk.addon.conversion.pdf2office.ConvertCallback 对象。 默认值：null。

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

注解
  当通过函数PDF2Office.initialize 设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

## ◆ startConvertToExcel() [2/2]

static Progressive com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.startConvertToExcel | ( | FileReaderCallback | src_pdf_reader,
|  | String | src_pdf_password,
|  | StreamCallback | saved_excel_file_stream,
|  | PDF2OfficeSettingData | setting_data,
|  | ConvertCallback | convert_callback
| ) |  | throws com.foxit.sdk.PDFException
| static

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

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

参数

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

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

注解
  当通过函数PDF2Office.initialize 设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

## ◆ startConvertToPowerPoint() [1/2]

static Progressive com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.startConvertToPowerPoint | ( | String | src_pdf_path,
|  | String | src_pdf_password,
|  | String | saved_ppt_file_path,
|  | PDF2OfficeSettingData | setting_data,
|  | ConvertCallback | convert_callback
| ) |  | throws com.foxit.sdk.PDFException
| 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 | 由用户实现的com.foxit.sdk.addon.conversion.pdf2office.ConvertCallback 对象， 用于在转换过程中暂停和通知转换进度。 这可以是null，意味着不暂停和通知转换进度。 如果这不是null，它应该是由用户实现的有效com.foxit.sdk.addon.conversion.pdf2office.ConvertCallback 对象。 默认值：null。

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

注解
  当通过函数PDF2Office.initialize 设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

## ◆ startConvertToPowerPoint() [2/2]

static Progressive com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.startConvertToPowerPoint | ( | FileReaderCallback | src_pdf_reader,
|  | String | src_pdf_password,
|  | StreamCallback | saved_ppt_file_stream,
|  | PDF2OfficeSettingData | setting_data,
|  | ConvertCallback | convert_callback
| ) |  | throws com.foxit.sdk.PDFException
| static

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

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

参数

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

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

注解
  当通过函数PDF2Office.initialize 设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

## ◆ startConvertToWord() [1/2]

static Progressive com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.startConvertToWord | ( | String | src_pdf_path,
|  | String | src_pdf_password,
|  | String | saved_word_file_path,
|  | PDF2OfficeSettingData | setting_data,
|  | ConvertCallback | convert_callback
| ) |  | throws com.foxit.sdk.PDFException
| 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 | 由用户实现的com.foxit.sdk.addon.conversion.pdf2office.ConvertCallback 对象， 用于在转换过程中暂停和通知转换进度。 这可以是null，意味着不暂停和通知转换进度。 如果这不是null，它应该是由用户实现的有效com.foxit.sdk.addon.conversion.pdf2office.ConvertCallback 对象。 默认值：null。

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

注解
  当通过函数PDF2Office.initialize 设置Foxit PDF转换引擎时，ConvertCallback将不起作用。

## ◆ startConvertToWord() [2/2]

static Progressive com.foxit.sdk.addon.conversion.pdf2office.PDF2Office.startConvertToWord | ( | FileReaderCallback | src_pdf_reader,
|  | String | src_pdf_password,
|  | StreamCallback | saved_word_file_stream,
|  | PDF2OfficeSettingData | setting_data,
|  | ConvertCallback | convert_callback
| ) |  | throws com.foxit.sdk.PDFException
| static

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

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

参数

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

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

注解
  当通过函数PDF2Office.initialize 设置Foxit PDF转换引擎时，ConvertCallback将不起作用。