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

OptionalContentConfigIDHet eerste standaardconfiguratiewoordenboek voor optionele inhoud heeft ID 1. Voor andere configuratiewoordenboeken voor optionele inhoud worden hogere nummers gebruikt
OptionalContentGroupIDEen ID geretourneerd door de functies NewOptionalContentGroup, GetOptionalContentGroupID of GetOptionalContentConfigOrderItemID
NewStateGeeft 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

0De status kon niet worden ingesteld
1De status is ingesteld int OptionalContentConfigID, int OptionalContentGroupID, int NewState);