StoreCustomDataFromFileA

Dokumentegenskaber

Beskrivelse

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

Gemmer brugerdefinerede data fra en fil i PDF-dokumentet under et nøglenavn. Disse data kan senere hentes med RetrieveCustomDataToString eller RetrieveCustomDataToFile. Lagringstypen (streng, stream eller komprimeret stream) og placeringen (Document Information Dictionary eller Document Catalog) kan angives. Hvis placeringen er Document Catalog, kan enhver lagringstype bruges, men nøglen skal have et særligt præfiks, som Adobe har tildelt dig. Hvis placeringen er Document Information Dictionary, kan enhver nøgle bortset fra standardnøglerne bruges, men der kan kun bruges strenge

Syntaks

Delphi

Function DLStoreCustomDataFromFileA(InstanceID: Integer; Key, FileName: PAnsiChar; Location, Options: Integer): Integer;

DLL

int DLStoreCustomDataFromFileA(int InstanceID, const char * Key, const char * FileName, int Location, int Options);

Parametre

KeyDen nøgle, dataene skal gemmes under. Hvis placeringen er dokumentinformationsordbogen, må nøglen ikke være "Author", "Title", "Subject", "Keywords", "Creator" eller "Producer". Enhver anden nøgle kan bruges, men nøgler bør vælges med omhu, så de giver mening for brugeren. Hvis placeringen er dokumentkataloget, skal nøglen have et særligt præfiks, som Adobe har tildelt dig, for at undgå konflikter med anden software.
FileNameStien til og navnet på filen med de data, der skal gemmes i PDF'en under den angivne nøgle
Location1 = Gem dataene i dokumentinformationsordbogen 2 = Gem dataene i dokumentkataloget
Options0 = Gem dataene som en streng (den eneste tilgængelige mulighed, hvis placeringen er Document Information Dictionary) 1 = Gem dataene i en stream 2 = Gem dataene i en komprimeret stream

Returværdier

0Filen med dataene kunne ikke åbnes, eller parameteren Key var ugyldig
1Dataene blev gemt