THotPDF.ImportLoadedFormFromXFDF Method

XFDF(XML Forms Data Format) 파일에서 폼 필드 값을 로드된 문서로 가져옵니다

가져오기는 모든 필드에 걸쳐 원자적입니다. 나중 갱신이 거부되면 이전 값과 생성된 appearance를 롤백하고, 성공한 가져오기는 호출자가 소유한 바깥 graph transaction을 그대로 유지합니다

여러 value 요소가 줄바꿈에서 텍스트를 잇거나 자르지 않고 multi-select choice 필드를 채웁니다. 지원되는 선택은 상위 기본값이나 형제 필드를 바꾸지 않고 필드 값과 선택 인덱스를 다시 만듭니다

value가 없는 field 요소는 기존 필드를 그대로 둡니다. 빈 값 하나는 빈 export 옵션이 없는 multi-select 필드를 지우고, 그 옵션이 존재하면 그것을 선택합니다

배열 값은 대상 필드를 바꾸기 전에 검증됩니다. 가시 텍스트나 choice appearance를 바꿔야 한다면 저장 전에 appearance 재생성을 명시적으로 요청하십시오

정확한 옵션 값이 옵션 순서와 무관하게 가져온 선택 목록 전체에서 우선합니다. 일치하지 않는 XFDF 텍스트만 16진 표기용 호환성 폴백을 쓸 수 있고, 폴백에 성공하면 실제로 일치한 옵션 값을 저장합니다

저수준 HPDFXFDFImportFields overload는 별도로 초기화된 THPDFXFDFArrayAccess 레코드를 받습니다. setter는 값 목록 전체를 처리한 뒤 true를 반환하고, 그렇지 않으면 값 하나는 스칼라 setter로 폴백되며 여러 값은 거부됩니다

기존 저수준 overload는 기존 통합을 위해 여러 값을 LF로 잇는 것을 포함해 구식 동작을 유지합니다. THotPDF는 배열을 인식하는 새 overload를 씁니다

Syntax

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Parameters

AFileName: TFileName

가져올 XFDF 데이터 파일 이름

Return Value

갱신된 필드 수를 반환합니다. 없는 파일은 0을 반환하고, 파일 I/O와 거부된 필드 갱신은 예외를 던질 수 있습니다