SetOptionalContentConfigState

Indholdsstrømme og grupper med valgfrit indhold

Beskrivelse

Denne funktion bruges til at angive tilstanden for en valgfri indholdsgruppe som defineret af den angivne konfigurationsordbog for valgfrit indhold.

Alle konfigurationsordbøger for valgfrit indhold har en basistilstand (enten ON, OFF eller Unchanged) og to medlemskabsarrays kaldet /ON og /OFF.

En reference til den valgfri indholdsgruppe føjes til det relevante /ON- eller /OFF-array (eller fjernes fra begge arrays) afhængigt af basistilstandens værdi.

En bestemt gruppe med valgfrit indhold kan kun sættes til Unchanged, hvis basistilstanden i konfigurationsordbogen for valgfrit indhold er Unchanged.

Basistilstanden for standardordbogen til optional-content-konfiguration (tilgås ved at sætte OptionalContentConfigID til 1) er altid ON, så optional-content-grupper i denne konfigurationsordbog kan kun sættes til ON eller OFF.

Syntaks

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

Parametre

OptionalContentConfigID	Den første standardkonfigurationsordbog for valgfrit indhold har id 1. Højere numre bruges til andre konfigurationsordbøger for valgfrit indhold
OptionalContentGroupID	Et ID returneret af funktionerne NewOptionalContentGroup, GetOptionalContentGroupID eller GetOptionalContentConfigOrderItemID
NewState	Angiver den tilstand, som optional-content-gruppen i denne konfigurationsordbog skal sættes til: 1 = Sæt til ON 2 = Sæt til OFF 3 = Lad være uændret (hvis muligt)

Returværdier

0	Tilstanden kunne ikke indstilles
1	Tilstanden blev angivet int OptionalContentConfigID, int OptionalContentGroupID, int NewState);