THotPDF.ImportLoadedFormFromXFDF Method

Importa i valori dei campi form da un file XML Forms Data Format (XFDF) nel documento caricato

L'importazione è atomica su tutti i campi: un aggiornamento successivo rifiutato fa rollback dei valori precedenti e delle appearance generate, mentre un'importazione riuscita preserva un'eventuale graph transaction contenente di proprietà del chiamante

Più elementi value popolano un campo choice multi-select senza unire o dividere il testo sulle interruzioni di riga; le selezioni supportate ricostruiscono il valore del campo e gli indici di selezione senza modificare i valori predefiniti degli antenati o i campi fratelli

Un elemento field senza value lascia invariato il campo esistente; un valore vuoto singolo svuota un campo multi-select senza opzione di esportazione vuota, oppure seleziona quell'opzione quando esiste

I valori array vengono validati prima di modificare il loro campo di destinazione; richiedi esplicitamente la rigenerazione delle appearance prima del salvataggio quando il testo visibile o le appearance delle scelte devono cambiare

I valori di opzione esatti hanno priorità sull'intera lista di selezione importata, indipendentemente dall'ordine delle opzioni; solo il testo XFDF non abbinato può usare il fallback di compatibilità per le grafie esadecimali, e un fallback riuscito memorizza il valore dell'opzione effettivamente abbinata

L'overload di basso livello HPDFXFDFImportFields accetta un record separato e inizializzato THPDFXFDFArrayAccess ; il suo setter restituisce true dopo aver gestito la lista completa dei valori, altrimenti un valore singolo passa al setter scalare e più valori vengono rifiutati

L'overload originale di basso livello conserva il suo comportamento legacy per le integrazioni esistenti, inclusa l'unione di più valori con LF; THotPDF uses the new array-aware overload

Syntax

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Parametri

AFileName: TFileName

Il nome del file dei dati XFDF da importare

Valore restituito

Restituisce il numero di campi aggiornati; un file mancante restituisce zero, mentre l'I/O su file e gli aggiornamenti di campi rifiutati possono sollevare eccezioni