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
| Key | Chiave 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 |
|---|---|
| NewValue | Il nuovo valore dei dati |
| Location | 1 = Memorizza nel dizionario informazioni documento 2 = Memorizza nel catalogo documento |
| Options | 0 = 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
| 0 | Non è stato possibile memorizzare i dati perché il nome della chiave era riservato |
|---|---|
| 1 | I dati sono stati memorizzati correttamente |