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