THotPDF.ImportLoadedFormFromXFDF Method

Importa valores de campos de formulário de um arquivo XML Forms Data Format (XFDF) para o documento carregado

A importação é atômica entre todos os campos: uma atualização posterior rejeitada desfaz valores anteriores e appearances geradas, enquanto uma importação bem-sucedida preserva qualquer transação de grafo externa que pertença ao chamador

Múltiplos elementos de valor populam um campo de escolha multi-select sem juntar ou dividir texto em quebras de linha; as seleções suportadas reconstruem o valor do campo e os índices de seleção sem modificar defaults de ancestrais ou campos irmãos

Um elemento de campo sem valor deixa o campo existente inalterado; um valor vazio limpa um campo multi-select sem opção de exportação vazia, ou seleciona essa opção quando ela existe

Valores em array são validados antes de alterar o campo de destino; solicite explicitamente a regeneração de appearances antes de salvar quando o texto visível ou as appearances de escolha precisarem mudar

Valores de opções exatos têm prioridade em toda a lista de seleção importada, independentemente da ordem das opções; apenas texto XFDF sem correspondência pode usar o fallback de compatibilidade para grafias hexadecimais, e um fallback bem-sucedido armazena o valor real da opção correspondente

A overload de baixo nível HPDFXFDFImportFields aceita um record THPDFXFDFArrayAccess separado e inicializado; o seu setter retorna true depois de processar a lista completa de valores; caso contrário, um valor único cai no setter escalar e múltiplos valores são rejeitados

A overload original de baixo nível mantém o comportamento legado para integrações existentes, incluindo juntar múltiplos valores com LF; THotPDF usa a nova overload consciente de arrays

Syntax

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Parâmetros

AFileName: TFileName

O nome do arquivo dos dados XFDF a importar

Valor de retorno

Retorna o número de campos atualizados; um arquivo ausente retorna zero, enquanto falhas de I/O de arquivo e atualizações de campo rejeitadas podem levantar exceções