SetOptionalContentConfigState
コンテンツストリームとオプショナルコンテンツグループ
説明
この関数は、指定したオプショナルコンテンツ設定辞書で定義されたオプショナルコンテンツグループの状態を設定します
すべてのオプショナルコンテンツ設定辞書は基本状態(ON、OFF、Unchanged のいずれか)と、/ON および /OFF と呼ばれる 2 つのメンバーシップ配列を持ちます
基本状態の値に応じて、オプショナルコンテンツグループへの参照が適切な /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) |