SetOptionalContentConfigState

内容流和可选内容组

描述

此函数用于按指定可选内容配置字典的定义设置可选内容组的状态

所有可选内容配置字典均具有基本状态(ON、OFF 或 Unchanged),以及名为 /ON 和 /OFF 的两个成员数组

根据基础状态的值,将对可选内容组的引用添加到相应的 /ON 或 /OFF 数组中,或从任一数组中移除

仅当可选内容配置字典的基础状态为 Unchanged 时,特定可选内容组才能设为 Unchanged

默认可选内容配置字典(通过将 OptionalContentConfigID 设置为 1 来访问)的基本状态始终为 ON,因此该配置字典中的可选内容组只能设为 ON 或 OFF

语法

Delphi

Function TPDFlib.SetOptionalContentConfigState(OptionalContentConfigID, OptionalContentGroupID, NewState: Integer): Integer;

ActiveX

Function PDFlib::SetOptionalContentConfigState(OptionalContentConfigID As Long, OptionalContentGroupID As Long, NewState As Long) As Long

DLL

int DLSetOptionalContentConfigState(int InstanceID, int OptionalContentConfigID, int OptionalContentGroupID, int NewState);

参数

OptionalContentConfigID第一个默认可选内容配置字典的 ID 为 1。其他可选内容配置字典使用更大的编号
OptionalContentGroupID由 NewOptionalContentGroup、GetOptionalContentGroupID 或 GetOptionalContentConfigOrderItemID 函数返回的 ID
NewState指定此配置字典中的可选内容组应设置的状态:1 = 设为 ON 2 = 设为 OFF 3 = 保持不变(如可能)

返回值

0无法设置状态
1已成功设置状态 int OptionalContentConfigID, int OptionalContentGroupID, int NewState)