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äritulostustyö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
| Key | Avain, 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 |
|---|---|
| NewValue | Datan uusi arvo |
| Location | 1 = tallenna data Document Information Dictionaryyn 2 = tallenna data Document Catalogiin |
| Options | 0 = tallenna data merkkijonona (ainoa vaihtoehto, kun sijaintina on Document Information Dictionary) 1 = tallenna data virtaan 2 = tallenna data pakattuun virtaan |
Paluuarvot
| 0 | Dataa ei voitu tallentaa, koska avainnimi oli varattu nimi |
|---|---|
| 1 | Datan tallennus onnistui |