SetOptionalContentConfigState
Contentstreams en groepen met optionele content
Beschrijving
Deze functie stelt de status in van een optionele contentgroep zoals gedefinieerd door het opgegeven optional content configuration-woordenboek
Alle optional content configuration-dictionary's hebben een basistoestand (ON, OFF of Unchanged) en twee lidmaatschapsarrays met de naam /ON en /OFF
Afhankelijk van de basistatus wordt een referentie naar de optionele contentgroep aan de juiste /ON- of /OFF-array toegevoegd (of uit een van beide arrays verwijderd)
Een specifieke optionele contentgroep kan alleen op Unchanged worden gezet als de basistatus van het optional content configuration-woordenboek Unchanged is
De basistatus van het standaard optional content configuration-woordenboek (benaderbaar door OptionalContentConfigID op 1 te zetten) is altijd ON, dus optionele contentgroepen in dit configuratiewoordenboek kunnen alleen op ON of OFF worden gezet
Syntaxis
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);
Parameters
| OptionalContentConfigID | Het eerste standaardconfiguratiewoordenboek voor optionele inhoud heeft ID 1. Voor andere configuratiewoordenboeken voor optionele inhoud worden hogere nummers gebruikt |
|---|---|
| OptionalContentGroupID | Een ID geretourneerd door de functies NewOptionalContentGroup, GetOptionalContentGroupID of GetOptionalContentConfigOrderItemID |
| NewState | Geeft de status op waarnaar de optionele contentgroep in dit configuratiewoordenboek moet worden gezet: 1 = Op ON zetten 2 = Op OFF zetten 3 = Ongewijzigd laten (indien mogelijk) |
Retourwaarden
| 0 | De status kon niet worden ingesteld |
|---|---|
| 1 | De status is ingesteld int OptionalContentConfigID, int OptionalContentGroupID, int NewState); |