继承自 Object .

静态 Public 成员函数
static bool	AddExternalFontPath (const wchar_t *font_path)
	添加外部字体路径。更多...

static void *	Alloc (size_t size)
	分配内存块更多...

static bool	EnableJavaScript (bool enable_javascript)
	启用或禁用PDF的JavaScript。更多...

static void	EnableThreadSafety (bool is_enable_thread_safety)
	启用线程安全。更多...

static WString	ExecuteJavaScript (const wchar_t *java_script)
	执行javascript。更多...

static foxit::ErrorCode	FlushLog ()
	刷新日志文件。更多...

static void	Free (void *ptr)
	释放内存块更多...

static RenderConfig	GetRenderConfig ()
	获取渲染配置。更多...

static String	GetVersion ()
	获取当前Foxit PDF SDK库的版本。更多...

static bool	HasModuleLicenseRight (common::ModuleName module_name)
	检查用户是否有权在当前使用的许可证信息中使用Foxit PDF SDK的指定模块（用于初始化Foxit PDF SDK）。更多...

static ErrorCode	Initialize (const char sn, const char key)
	使用有效的许可证信息初始化Foxit PDF SDK库。更多...

static ErrorCode	Initialize (const char sn, const char key, bool is_optimize_memory, bool enable_js_xfa_threadsafety=false)
	使用有效的许可证信息初始化Foxit PDF SDK库。更多...

static ErrorCode	InitializeOFDEngine (const char *ofd_library_path)
	初始化OFD引擎。更多...

static void	MatchExternalFontsOnly (bool only_match)
	是否只匹配外部指定路径。更多...

static void *	Realloc (void *ptr, size_t new_size)
	重新分配内存块。更多...

static bool	RegisterSecurityCallback (const char filter, pdf::SecurityCallback callback)
	向Foxit PDF SDK注册 pdf::SecurityCallback 对象用于解密具有特殊加密过滤器的PDF。更多...

static bool	RegisterSignatureCallback (const char filter, const char sub_filter, pdf::SignatureCallback *signature_callback)
	向Foxit PDF SDK注册第三方 pdf::SignatureCallback 对象用于签名和验证签名，以及回调的过滤器和子过滤器名称。更多...

static void	RegisterXFAAppProviderCallback (addon::xfa::AppProviderCallback *callback)
	向Foxit PDF SDK注册 addon::xfa::AppProviderCallback 对象。更多...

static ErrorCode	Reinitialize ()
	重新初始化Foxit PDF SDK库。更多...

static void	Release ()
	释放Foxit PDF SDK库分配的所有资源。更多...

static void	ReleaseOFDEngine ()
	释放OFD引擎。更多...

static bool	SetActionCallback (ActionCallback *action_callback)
	设置 foxit::ActionCallback 对象到Foxit PDF SDK，以帮助执行PDF动作。更多...

static bool	SetAnnotIconProviderCallback (pdf::annots::IconProviderCallback *annot_icon_provider)
	设置自定义的 pdf::annots::IconProviderCallback 对象到Foxit PDF SDK。更多...

static bool	SetCacheSize (uint32 size)
	设置PDF库缓存大小的上限。更多...

static void	SetDefaultICCProfilesPath (const wchar_t *icc_profile_folder_path)
	设置包含默认ICC配置文件的文件夹路径。更多...

static bool	SetDocEventCallback (DocEventCallback *callback)
	设置 DocEventCallback 对象到Foxit PDF SDK。更多...

static bool	SetFontMapperCallback (FontMapperCallback *callback)
	设置 FontMapperCallback 对象到Foxit PDF SDK。更多...

static void	SetLogFile (const char *log_file_path)
	设置日志文件路径。更多...

static void	SetLogFile (const wchar_t *log_file_path)
	设置日志文件路径。更多...

static void	SetLogFile (foxit::common::file::StreamCallback *log_file)
	设置日志文件流。更多...

static bool	SetNotifierCallback (NotifierCallback *notifier)
	设置 NotifierCallback 对象到Foxit PDF SDK。更多...

static void	SetRenderConfig (const RenderConfig &render_config)
	设置渲染配置。更多...

static void	SetRenderTextGamma (float gamma)
	设置文本渲染的伽马值。更多...

static bool	SetTimeStampCallback (pdf::TimeStampCallback *timestamp_callback)
	设置 pdf::TimeStampCallback 对象到Foxit PDF SDK，以帮助与时间戳服务器交互。更多...

static bool	UnregisterSecurityCallback (const char *filter)
	从Foxit PDF SDK中取消注册 pdf::SecurityCallback 对象。更多...

static void	UnregisterSignatureCallback (const char filter, const char sub_filter)
	取消注册与特定过滤器和子过滤器关联的第三方 pdf::SignatureCallback 对象从Foxit PDF SDK中。如果有可用的默认签名，它将与其过滤器和子过滤器值一起恢复。更多...

详细描述

此类表示库管理。它包含初始化/重新初始化/释放Foxit PDF SDK库的函数，还包含全局使用的函数。
任何应用程序都应该在调用任何其他Foxit PDF SDK函数之前，通过函数 Library::Initialize 加载Foxit PDF SDK。当不再需要使用Foxit PDF SDK时，请调用函数 Library::Release。
当发生某些错误时，Foxit PDF SDK中的函数可能会抛出异常。用户可以捕获这些异常并检查从 foxit::e_ErrFile 开始的错误代码值，以了解更多关于发生了什么错误的信息。

注解: 在应用程序的生命周期中，Library::Initialize 和 Library::Release 应该成对调用，且只能调用一次。一旦在应用程序的生命周期中调用了 Library::Release，在该应用程序的生命周期中就无法再初始化Foxit PDF SDK。在调用 Library::Release 之前，如果用户想重新初始化Foxit PDF SDK，请参考函数 Library::Reinitialize。

成员函数说明

◆ AddExternalFontPath()

static bool foxit::common::Library::AddExternalFontPath ( const wchar_t * font_path )

static

添加外部字体路径。

参数

[in] font_path 外部字体路径。

返回: true 表示成功，false 表示失败。

◆ Alloc()

static void* foxit::common::Library::Alloc ( size_t size )

static

分配内存块

当不再使用内存块时，请记住调用函数 Library::Free 来释放内存块。

参数

[in] size 要分配的字节数。

返回: 指向已分配内存块的指针。

◆ EnableJavaScript()

static bool foxit::common::Library::EnableJavaScript ( bool enable_javascript )

static

启用或禁用PDF的JavaScript。

PDF的JavaScript默认是启用的。

参数

[in] enable_javascript true 表示启用JavaScript，false 表示禁用JavaScript。如果不调用此函数，PDF的JavaScript默认是启用的。

返回: true 表示成功，false 表示失败。

◆ EnableThreadSafety()

static void foxit::common::Library::EnableThreadSafety ( bool is_enable_thread_safety )

static

启用线程安全。

从Foxit PDF SDK 11.0开始，默认情况下启用文档级别的线程安全（除Javascript和xfa模块外）而无需调用此函数。此函数将在未来版本中被弃用。用户需要确保一个pdf文档同时只被一个线程操作。如果用户要为javascript和xfa模块启用线程安全，请在调用函数 Library::Initialize 时向 enable_js_xfa_threadsafety 传递 true。

目前，模块"OCR"不支持线程安全。

参数

[in] is_enable_thread_safety 启用线程安全。true 表示启用线程安全， false 表示禁用线程安全。

返回: 无。

◆ ExecuteJavaScript()

static WString foxit::common::Library::ExecuteJavaScript ( const wchar_t * java_script )

static

执行javascript。

参数

java_script 需要执行的javascript。

返回: 结果错误信息，如语法错误警告、不支持警告和其他错误消息。

◆ FlushLog()

static foxit::ErrorCode foxit::common::Library::FlushLog ( )

static

刷新日志文件。

返回: 错误代码。

◆ Free()

static void foxit::common::Library::Free ( void * ptr )

static

释放内存块

参数

[in] ptr 指向由函数 Library::Alloc 分配的要释放的内存块的指针。

返回: 无。

◆ GetRenderConfig()

static RenderConfig foxit::common::Library::GetRenderConfig ( )

static

获取渲染配置。

返回: 显示当前配置的渲染配置对象。

◆ GetVersion()

static String foxit::common::Library::GetVersion ( )

static

获取当前Foxit PDF SDK库的版本。

返回: 版本字符串。

◆ HasModuleLicenseRight()

static bool foxit::common::Library::HasModuleLicenseRight ( common::ModuleName module_name )

static

检查用户是否有权在当前使用的许可证信息中使用Foxit PDF SDK的指定模块（用于初始化Foxit PDF SDK）。

在Foxit PDF SDK中，一旦库成功初始化，大多数功能都可以使用。但对于某些特殊功能，只有在许可证信息中定义了指定模块时才能使用。此函数可用于在使用这些功能之前检查用户是否具有这些特殊模块的权限。

参数

[in] module_name 要检查权限的模块名称。请参考从 common::e_ModuleNameConnectedPDF 开始的值，这应该是这些值中的一个。

返回: true 表示用户有权使用指定模块，false 表示用户没有使用指定模块的权限。

◆ Initialize() [1/2]

static ErrorCode foxit::common::Library::Initialize	(	const char *	sn,
		const char *	key
	)

static

使用有效的许可证信息初始化Foxit PDF SDK库。

在应用程序的生命周期中，此函数只能调用一次，并且应该在调用Foxit PDF SDK中的任何其他函数之前首先调用。
一旦调用了函数 Library::Release，Foxit PDF SDK库就无法在该应用程序的生命周期中再次初始化。

参数

[in]	sn	SN信息字符串，可以从密钥文件"gsdk_sn.txt"或"rdk_sn.txt"中的"SN="部分获取。
[in]	key	密钥信息字符串，可以从密钥文件"gsdk_key.txt"或"rdk_key.txt"中的"Sign="部分获取。

返回: foxit::e_ErrSuccess 表示成功。
foxit::e_ErrInvalidLicense 表示输入的许可证信息无效。
foxit::e_ErrParam 表示参数 sn 或 key 是空字符串。
有关错误代码值的更多信息，请参考从 foxit::e_ErrSuccess 开始的值。

◆ Initialize() [2/2]

static ErrorCode foxit::common::Library::Initialize	(	const char *	sn,
		const char *	key,
		bool	is_optimize_memory,
		bool	enable_js_xfa_threadsafety = `false`
	)

static

使用有效的许可证信息初始化Foxit PDF SDK库。

在应用程序的生命周期中，此函数只能调用一次，并且应该在调用Foxit PDF SDK中的任何其他函数之前首先调用。
一旦调用了函数 Library::Release，Foxit PDF SDK库就无法在该应用程序的生命周期中再次初始化。

参数

[in]	sn	SN信息字符串，可以从密钥文件"gsdk_sn.txt"或"rdk_sn.txt"中的"SN="部分获取。
[in]	key	密钥信息字符串，可以从密钥文件"gsdk_key.txt"或"rdk_key.txt"中的"Sign="部分获取。
[in]	app_name	应用程序名称字符串。

返回: foxit::e_ErrSuccess 表示成功。
foxit::e_ErrInvalidLicense 表示输入的许可证信息无效。
foxit::e_ErrParam 表示参数 sn 或 key 是空字符串。
有关错误代码值的更多信息，请参考从 foxit::e_ErrSuccess 开始的值。使用有效的许可证信息初始化Foxit PDF SDK库。

在应用程序的生命周期中，此函数只能调用一次，并且应该在调用Foxit PDF SDK中的任何其他函数之前首先调用。
一旦调用了函数 Library::Release，Foxit PDF SDK库就无法在该应用程序的生命周期中再次初始化。

参数

[in]	sn	SN信息字符串，可以从密钥文件"gsdk_sn.txt"或"rdk_sn.txt"中的"SN="部分获取。
[in]	key	密钥信息字符串，可以从密钥文件"gsdk_key.txt"或"rdk_key.txt"中的"Sign="部分获取。
[in]	is_optimize_memory	此标志用于尝试通过清理内存碎片来优化内存。 true 表示清理内存碎片，false 表示不清理。
[in]	enable_js_xfa_threadsafety	此标志用于启用JavaScript和XFA模块的线程安全。 true 表示启用，false 表示不启用。默认值为 false。用户需要确保一个PDF文档一次只由一个线程操作。

返回: foxit::e_ErrSuccess 表示成功。
foxit::e_ErrInvalidLicense 表示输入的许可证信息无效。
foxit::e_ErrParam 表示参数 sn 或 key 是空字符串。
有关错误代码值的更多信息，请参考从 foxit::e_ErrSuccess 开始的值。

◆ InitializeOFDEngine()

static ErrorCode foxit::common::Library::InitializeOFDEngine ( const char * ofd_library_path )

static

初始化OFD引擎。

在使用"OFD"模块中的任何其他函数之前必须调用此函数。在使用"OFD"模块之前，请确保OFD包中名为"lib"的资源文件夹是有效的。在初始化OFD引擎并使用此模块中的任何类或方法之前，请确保 Foxti PDF SDK已通过函数 common::Library::Initialize 使用包含"OFD"模块的密钥成功初始化。
目前，"OFD"模块仅支持Windows和Linux64系统。

参数

[in] ofd_library_path OFD库的路径。这不应该是空字符串。

返回: foxit::e_ErrSuccess 表示成功。
有关错误代码值的更多信息，请参考从 foxit::e_ErrSuccess 开始的值。

◆ MatchExternalFontsOnly()

static void foxit::common::Library::MatchExternalFontsOnly ( bool only_match )

static

是否只匹配外部指定路径。

参数

[in] only_match true 表示只匹配通过 Library::AddExternalFontPath 添加的外部路径。默认值：false。

返回: 无。

◆ Realloc()

static void* foxit::common::Library::Realloc	(	void *	ptr,
		size_t	new_size
	)

static

重新分配内存块。

如果参数 ptr 为 NULL，此函数将分配一个新的内存块。

参数

[in]	ptr	指向由 Library::Alloc 分配的内存块的指针现在要重新分配。NULL 表示此函数将分配一个新的内存块。
[in]	new_size	内存块的新大小（字节）。

返回: 指向新重新分配的内存块的指针。

◆ RegisterSecurityCallback()

static bool foxit::common::Library::RegisterSecurityCallback	(	const char *	filter,
		pdf::SecurityCallback *	callback
	)

static

向Foxit PDF SDK注册 pdf::SecurityCallback 对象用于解密具有特殊加密过滤器的PDF。

当此函数成功时，Foxit PDF SDK将接管输入的安全回调对象，用户不应再直接释放此回调对象；否则稍后可能发生意外崩溃。
当取消注册安全回调对象并发现它没有被其他对象使用时， Foxit PDF SDK可能通过回调函数 pdf::SecurityCallback::Release 释放安全回调对象。因此，建议用户在函数 Library::UnregisterSecurityCallback 之后不再使用安全回调对象。

参数

[in]	filter	安全回调对象的过滤器名称。这不应该是 NULL 或空字符串。当用户实现 pdf::CustomSecurityCallback 的安全回调时，用户可以指定自己的自定义过滤器字符串，但需要遵循PDF名称约定。当用户实现 pdf::CertificateSecurityCallback 的安全回调时，过滤器值必须设置为"Adobe.PubSec"。当用户实现 pdf::DRMSecurityCallback 的安全回调时，过滤器值必须设置为"FoxitDRM"，否则稍后可能发生错误。当用户实现 pdf::RMSSecurityCallback 的安全回调时，过滤器值必须设置为"MicrosoftIRMServices"或"FoxitRMS"，否则稍后可能发生错误。
[in]	callback	pdf::SecurityCallback 对象，由用户实现并基于回调类 pdf::SecurityCallback。用户不应直接继承 pdf::SecurityCallback，而应继承其派生类，如 pdf::CustomSecurityCallback、pdf::CertificateSecurityCallback 等。

返回: true 表示成功，false 表示失败。

注解: 如果在函数 Library::Initialize 中使用的许可证信息中未定义模块"RMS"，这意味着用户无权使用RMS相关功能，此函数将抛出异常 foxit::e_ErrNoRMSModuleRight。

◆ RegisterSignatureCallback()

static bool foxit::common::Library::RegisterSignatureCallback	(	const char *	filter,
		const char *	sub_filter,
		pdf::SignatureCallback *	signature_callback
	)

static

向Foxit PDF SDK注册第三方 pdf::SignatureCallback 对象用于签名和验证签名，以及回调的过滤器和子过滤器名称。

Foxit PDF SDK具有默认的签名回调，定义了过滤器和子过滤器：

过滤器："Adobe.PPKLite"，子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"，子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"，子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"，子过滤器："ETSI.RFC3161"

如果用户想使用第三方签名回调，请在签名或验证签名过程之前调用此函数。
如果用户通过此函数注册一个与默认签名回调具有相同过滤器和子过滤器的自定义签名回调，且参数 signature_callback 的值不是 NULL， Foxit PDF SDK中的默认签名回调将不起作用。如果用户通过此函数注册一个与默认签名回调具有相同过滤器和子过滤器的自定义签名回调，且参数 signature_callback 的值是 NULL， Foxit PDF SDK中的默认签名回调将重新生效。

参数

[in]	filter	签名回调的过滤器名称，使用ASCII编码。这不应该是空字符串。过滤器名称是签名回调的名称。
[in]	sub_filter	签名回调的子过滤器名称，使用ASCII编码。子过滤器用于描述签名值的编码和签名字典中的密钥信息。
[in]	signature_callback	自定义的 pdf::SignatureCallback 对象，由用户实现并基于回调类 pdf::SignatureCallback。用户应确保所有回调函数都已在应用程序级别实现，还应确保此签名回调对象在通过函数 Library::Release 释放Foxit PDF SDK之前保持有效。如果这是 NULL，表示要从Foxit PDF SDK中移除已注册的第三方回调。

返回: true 表示成功，false 表示失败。

◆ RegisterXFAAppProviderCallback()

static void foxit::common::Library::RegisterXFAAppProviderCallback ( addon::xfa::AppProviderCallback * callback )

static

向Foxit PDF SDK注册 addon::xfa::AppProviderCallback 对象。

在处理XFA文档之前应首先调用此函数。

参数

[in] callback addon::xfa::AppProviderCallback 对象，由用户实现并基于回调类 addon::xfa::AppProviderCallback。用户应确保所有回调函数都已在应用程序级别实现，还应确保此XFA应用程序提供程序回调对象在通过函数 Library::Release 释放Foxit PDF SDK之前保持有效。

返回: 无。

注解: 如果在函数 Library::Initialize 中使用的许可证信息中未定义模块"XFA"，这意味着用户无权使用XFA相关功能，此函数将抛出异常 foxit::e_ErrNoXFAModuleRight。

◆ Reinitialize()

static ErrorCode foxit::common::Library::Reinitialize ( )

static

重新初始化Foxit PDF SDK库。

当用户遇到内存不足错误或用户想在调用函数 Library::Release 之前重新初始化Foxit PDF SDK库时，用户可以调用此函数来重新初始化Foxit PDF SDK库。
一旦调用了函数 Library::Release，Foxit PDF SDK库就无法在该应用程序的生命周期中再次初始化。

返回: foxit::e_ErrSuccess 表示成功。有关错误代码值的更多信息，请参考从 foxit::e_ErrSuccess 开始的值。

◆ Release()

static void foxit::common::Library::Release ( )

static

释放Foxit PDF SDK库分配的所有资源。

用户应该调用此函数来释放库分配的所有内存块。
一旦调用此函数，Foxit PDF SDK库就无法在应用程序的生命周期中再次初始化。

返回: 无。

◆ ReleaseOFDEngine()

static void foxit::common::Library::ReleaseOFDEngine ( )

static

释放OFD引擎。

当不再需要使用OFD引擎时，可以在释放Foxit PDF SDK之前调用此函数来释放OFD引擎。

返回: 无。

◆ SetActionCallback()

static bool foxit::common::Library::SetActionCallback ( ActionCallback * action_callback )

static

设置 foxit::ActionCallback 对象到Foxit PDF SDK，以帮助执行PDF动作。

用户应该实现一个动作回调对象并调用此函数来设置动作回调对象到Foxit PDF SDK，如果需要执行PDF动作，例如填写PDF表单。

参数

[in] action_callback 自定义的 foxit::ActionCallback 对象。NULL 表示不使用任何动作回调对象。用户应确保所有回调函数都已在应用程序级别实现。如果这是一个有效的动作回调对象，Foxit PDF SDK将接管此回调对象的管理，用户不应直接释放它。

返回: true 表示成功，false 表示失败。

◆ SetAnnotIconProviderCallback()

static bool foxit::common::Library::SetAnnotIconProviderCallback ( pdf::annots::IconProviderCallback * annot_icon_provider )

static

设置自定义的 pdf::annots::IconProviderCallback 对象到Foxit PDF SDK。

用户可以调用此函数为注释设置自定义图标提供程序。如果此函数被多次调用，Foxit PDF SDK将只保留最后一个图标提供程序。如果此函数从未被调用过，Foxit PDF SDK将使用默认的标准图标提供程序。

参数

[in] annot_icon_provider 自定义的注释图标提供程序，基于回调类 pdf::annots::IconProviderCallback 实现。如果这是 NULL，自定义注释图标提供程序将从Foxit PDF SDK中移除，并使用默认的标准图标提供程序。应用程序应确保此图标提供程序对象在被从Foxit PDF SDK中移除或调用函数 Library::Release 之前保持有效。

返回: true 表示成功，false 表示失败。

注解: 图标提供程序的ID和版本被视为图标提供程序的名称，因此请通过回调函数 pdf::annots::IconProviderCallback::GetProviderID 和 pdf::annots::IconProviderCallback::GetProviderVersion 为不同的图标提供程序提供不同的"ID + 版本"。

◆ SetCacheSize()

static bool foxit::common::Library::SetCacheSize ( uint32 size )

static

设置PDF库缓存大小的上限。

如果应用程序没有设置缓存大小限制，默认情况下缓存大小将在内部设置为200兆字节。

参数

[in] size 缓存的上限，单位为兆字节，范围0~4096。如果设置为0，表示不使用缓存大小限制。

返回: true 表示成功，false 表示失败。

◆ SetDefaultICCProfilesPath()

static void foxit::common::Library::SetDefaultICCProfilesPath ( const wchar_t * icc_profile_folder_path )

static

设置包含默认ICC配置文件的文件夹路径。

默认ICC配置文件在Foxit PDF SDK包的"res"文件夹中提供。默认ICC配置文件 "sRGB Color Space Profile.icm"、"sGray.icc"和"USWebCoatedSWOP.icc"。Foxit PDF SDK将从输入的文件夹路径中加载这些默认的ICC配置文件。
如果输入的文件夹路径不存在或指定文件夹中没有包含所有默认的ICC配置文件，此函数将抛出异常 foxit::e_ErrFilePathNotExist。

参数

[in] icc_profile_folder_path 包含默认ICC配置文件的有效文件夹路径。

返回: 无。

◆ SetDocEventCallback()

static bool foxit::common::Library::SetDocEventCallback ( DocEventCallback * callback )

static

设置 DocEventCallback 对象到Foxit PDF SDK。

参数

[in] callback DocEventCallback 对象。 NULL 表示不使用任何文档事件回调对象。

返回: true 表示成功，false 表示失败。

◆ SetFontMapperCallback()

static bool foxit::common::Library::SetFontMapperCallback ( FontMapperCallback * callback )

static

设置 FontMapperCallback 对象到Foxit PDF SDK。

一旦向Foxit PDF SDK设置了有效的自定义字体映射器回调， Foxit PDF SDK将在映射字体时首先使用此回调。

参数

[in] callback FontMapperCallback 对象。 NULL 表示不使用任何自定义字体映射器回调对象。

返回: true 表示成功，false 表示失败。

◆ SetLogFile() [1/3]

static void foxit::common::Library::SetLogFile ( const char * log_file_path )

static

设置日志文件路径。

在向Foxit PDF SDK设置日志文件路径后，所有日志都将写入日志文件。目前，Foxit PDF SDK中的日志信息比较简单；这将在未来版本中改进。

参数

[in] log_file_path 日志文件路径。

返回: 无。

◆ SetLogFile() [2/3]

static void foxit::common::Library::SetLogFile ( const wchar_t * log_file_path )

static

设置日志文件路径。

在向Foxit PDF SDK设置日志文件路径后，所有日志都将写入日志文件。目前，Foxit PDF SDK中的日志信息比较简单；这将在未来版本中改进。

参数

[in] log_file_path 日志文件路径。

返回: 无。

◆ SetLogFile() [3/3]

static void foxit::common::Library::SetLogFile ( foxit::common::file::StreamCallback * log_file )

static

设置日志文件流。

在向Foxit PDF SDK设置日志文件后，所有日志都将写入日志文件流。目前，Foxit PDF SDK中的日志信息比较简单；这将在未来版本中改进。

参数

[in] log_file 日志文件流。

返回: 无。

◆ SetNotifierCallback()

static bool foxit::common::Library::SetNotifierCallback ( NotifierCallback * notifier )

static

设置 NotifierCallback 对象到Foxit PDF SDK。

用户可以调用此函数向Foxit PDF SDK设置通知回调对象，以便在事件（如OOM）发生时通知用户。

参数

[in] notifier NotifierCallback 对象。用户应确保所有回调函数都已在应用程序级别实现。

返回: true 表示成功，false 表示失败。

◆ SetRenderConfig()

static void foxit::common::Library::SetRenderConfig ( const RenderConfig & render_config )

static

设置渲染配置。

参数

[in] render_config 要设置的渲染配置对象。

返回: 无。

◆ SetRenderTextGamma()

static void foxit::common::Library::SetRenderTextGamma ( float gamma )

static

设置文本渲染的伽马值。

如果不调用此函数设置伽马值，Foxit PDF SDK将使用2.2作为默认值。

参数

[in] gamma 伽马值。应该大于0。

返回: 无。

◆ SetTimeStampCallback()

static bool foxit::common::Library::SetTimeStampCallback ( pdf::TimeStampCallback * timestamp_callback )

static

设置 pdf::TimeStampCallback 对象到Foxit PDF SDK，以帮助与时间戳服务器交互。

当此函数成功时，Foxit PDF SDK将在签名期间接管默认的时间戳交互，用户不应再直接释放此回调对象；否则稍后可能发生意外崩溃。
当 timestamp_callback 为 NULL 时， Foxit PDF SDK可能通过回调函数 pdf::TimeStampCallback::Release 释放时间戳回调对象。

参数

[in] timestamp_callback 自定义的 pdf::TimeStampCallback 对象，由用户实现并基于回调类 pdf::TimeStampCallback。用户应确保所有回调函数都已在应用程序级别实现，还应确保此时间戳回调对象在通过函数 Library::Release 释放Foxit PDF SDK之前保持有效。
如果这是 NULL，表示要从Foxit PDF SDK中移除已注册的第三方回调。

返回: true 表示成功，false 表示失败。

◆ UnregisterSecurityCallback()

static bool foxit::common::Library::UnregisterSecurityCallback ( const char * filter )

static

从Foxit PDF SDK中取消注册 pdf::SecurityCallback 对象。

当取消注册安全回调函数并发现它没有被其他对象使用时， Foxit PDF SDK可能通过回调函数 pdf::SecurityCallback::Release 释放安全回调函数。因此，建议用户在函数 Library::UnregisterSecurityCallback 之后不再使用安全回调对象。

参数

[in] filter 用于注册安全回调对象的过滤器名称。请参考函数 Library::RegisterSecurityCallback 中参数 filter 的注释。

返回: true 表示成功，false 表示失败。

注解: 如果在函数 Library::Initialize 中使用的许可证信息中未定义模块"RMS"，这意味着用户无权使用RMS相关功能，此函数将抛出异常 foxit::e_ErrNoRMSModuleRight。

◆ UnregisterSignatureCallback()

static void foxit::common::Library::UnregisterSignatureCallback	(	const char *	filter,
		const char *	sub_filter
	)

static

取消注册与特定过滤器和子过滤器关联的第三方 pdf::SignatureCallback 对象从Foxit PDF SDK中。如果有可用的默认签名，它将与其过滤器和子过滤器值一起恢复。

Foxit PDF SDK具有默认的签名回调，定义了过滤器和子过滤器：

过滤器："Adobe.PPKLite"，子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"，子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"，子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"，子过滤器："ETSI.RFC3161"

参数

[in]	filter	签名回调的过滤器名称，使用ASCII编码。这不应该是空字符串。过滤器名称是签名回调的名称。
[in]	sub_filter	签名回调的子过滤器名称，使用ASCII编码。子过滤器用于描述签名值的编码和签名字典中的密钥信息。

返回: 无。

静态 Public 成员函数

详细描述

成员函数说明

◆ AddExternalFontPath()

◆ Alloc()

◆ EnableJavaScript()

◆ EnableThreadSafety()

◆ ExecuteJavaScript()

◆ FlushLog()

◆ Free()

◆ GetRenderConfig()

◆ GetVersion()

◆ HasModuleLicenseRight()

◆ Initialize() [1/2]

◆ Initialize() [2/2]

◆ InitializeOFDEngine()

◆ MatchExternalFontsOnly()

◆ Realloc()

◆ RegisterSecurityCallback()

◆ RegisterSignatureCallback()

◆ RegisterXFAAppProviderCallback()

◆ Reinitialize()

◆ Release()

◆ ReleaseOFDEngine()

◆ SetActionCallback()

◆ SetAnnotIconProviderCallback()

◆ SetCacheSize()

◆ SetDefaultICCProfilesPath()

◆ SetDocEventCallback()

◆ SetFontMapperCallback()

◆ SetLogFile() [1/3]

◆ SetLogFile() [2/3]

◆ SetLogFile() [3/3]

◆ SetNotifierCallback()

◆ SetRenderConfig()

◆ SetRenderTextGamma()

◆ SetTimeStampCallback()

◆ UnregisterSecurityCallback()

◆ UnregisterSignatureCallback()