SetCatalogInformationA

Dokumentegenskaber

Beskrivelse

Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med SetCatalogInformation, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Denne funktion giver mulighed for at gemme brugerdefinerede oplysninger i PDF-dokumentet. Den svarer til funktionen SetCustomInformation, men oplysningerne gemmes i dokumentkataloget i stedet for dokumentinformationsordbogen. Metadata bør gemmes i dokumentinformationsordbogen med SetCustomInformation, mens privat indhold eller strukturelle oplysninger bør gemmes i dokumentkataloget med denne funktion.

Nøglen må ikke være en systemnøgle i Catalog, som biblioteket eller PDF-specifikationen administrerer. Reserverede navne omfatter Type, Version, Extensions, Pages, PageLabels, Names, Dests, ViewerPreferences, OpenAction, AA, AcroForm, Metadata, StructTreeRoot, MarkInfo, Lang, SpiderInfo, OutputIntents, PieceInfo, OCProperties, Perms, Legal, Requirements, Collection og NeedsRendering.

Syntaks

Delphi

Function DLSetCatalogInformationA(InstanceID: Integer; Key, NewValue: PAnsiChar): Integer;

DLL

int DLSetCatalogInformationA(int InstanceID, const char * Key, const char * NewValue);

Parametre

KeyNavnet på den nøgle, der skal angives. Nøglen skal have et særligt præfiks, som Adobe har tildelt dig, for at undgå konflikter med anden software
NewValueDen nye værdi for den angivne nøgle.

Returværdier

0Den angivne nøgle kunne ikke sættes; den kan have været en systemnøgle
1Værdien for den angivne nøgle blev indstillet