StoreCustomDataFromString

Proprietà del documento

Descrizione

Salva dati personalizzati nel PDF con un nome di chiave. I dati possono essere recuperati in seguito con RetrieveCustomDataToString, RetrieveCustomDataToVariant o RetrieveCustomDataToFile. È possibile impostare tipo di archiviazione (stringa, flusso o flusso compresso) e posizione (Document Information Dictionary o Document Catalog). Nel Document Catalog è consentito qualsiasi tipo, ma la chiave deve avere un prefisso speciale assegnato da Adobe. Nel Document Information Dictionary è consentita qualsiasi chiave diversa da quelle standard, ma sono ammesse solo stringhe

Quando Location è 2, le chiavi di sistema del catalogo sono riservate e restituiscono 0 anziché essere sovrascritte. L'insieme riservato include OutputIntents, gestito dai flussi di lavoro PDF/A e dell'output a colori

Sintassi

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

Parametri

KeyChiave con cui memorizzare i dati. Se la posizione è il dizionario delle informazioni del documento, la chiave non può essere "Author", "Title", "Subject", "Keywords", "Creator" o "Producer". È possibile usare qualsiasi altra chiave, ma è necessario sceglierla con attenzione affinché sia comprensibile all'utente. Se la posizione è il catalogo del documento, la chiave deve avere un prefisso speciale assegnato da Adobe per evitare conflitti con altri software
NewValueIl nuovo valore dei dati
Location1 = Memorizza nel dizionario informazioni documento 2 = Memorizza nel catalogo documento
Options0 = Memorizza i dati come stringa (l'unica opzione disponibile se la posizione è il Document Information Dictionary) 1 = Memorizza i dati in un flusso 2 = Memorizza i dati in un flusso compresso

Valori restituiti

0Non è stato possibile memorizzare i dati perché il nome della chiave era riservato
1I dati sono stati memorizzati correttamente