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) |