StoreCustomDataFromString

Asiakirjan ominaisuudet

Kuvaus

Tallentaa mukautetun datan PDF:ään avainnimen alle. Datan voi myöhemmin hakea funktioilla RetrieveCustomDataToString, RetrieveCustomDataToVariant tai RetrieveCustomDataToFile. Tallennustyyppi (merkkijono, virta tai pakattu virta) ja sijainti (Document Information Dictionary tai Document Catalog) voi valita. Jos sijaintina on Document Catalog, tallennustyyppi voi olla mikä tahansa, mutta avaimessa on käytettävä Adobelta osoitettua erityistä etuliitettä. Jos sijaintina on Document Information Dictionary, avain voi olla mikä tahansa muu kuin vakiotoavain, mutta vain merkkijonoja voi käyttää

Kun Location on 2, katalogin järjestelmäavaimet ovat varattuja ja palauttavat arvon 0 sen sijaan että ne ylikirjoitettaisiin. Varattuun joukkoon kuuluu OutputIntents, jota PDF/A- ja väritulostus­työnkulut hallinnoivat

Syntaksi

Delphi

Function TPDFlib.StoreCustomDataFromString(Const Key, NewValue: AnsiString; Location, Options: Integer): Integer;

DLL

int DLStoreCustomDataFromString(int InstanceID, const char * Key, const char * NewValue, int Location, int Options);

Parametrit

KeyAvain, jonka alle data tallennetaan. Jos sijaintina on Document Information Dictionary, avain ei voi olla "Author", "Title", "Subject", "Keywords", "Creator" tai "Producer". Muita avaimia voi käyttää vapaasti, mutta ne kannattaa valita huolella niin, että ne ovat käyttäjälle merkityksellisiä. Jos sijaintina on Document Catalog, avaimessa on käytettävä Adobelta sinulle osoitettua erityistä etuliitettä, jotta muu ohjelmisto ei pääse niihin käsiksi
NewValueDatan uusi arvo
Location1 = tallenna data Document Information Dictionaryyn 2 = tallenna data Document Catalogiin
Options0 = tallenna data merkkijonona (ainoa vaihtoehto, kun sijaintina on Document Information Dictionary) 1 = tallenna data virtaan 2 = tallenna data pakattuun virtaan

Paluuarvot

0Dataa ei voitu tallentaa, koska avainnimi oli varattu nimi
1Datan tallennus onnistui