SetXFAFormFieldValueA

양식 필드

설명

끝의 A는 ANSI(char) DLL 진입점을 나타내며 ActiveX/COM 표면은 Unicode 형식만 노출합니다. 동작은 SetXFAFormFieldValue와 동일하며 문자열 인수는 현재 SetAnsiMode 코드 페이지로 해석됩니다

지정한 XFA 양식 필드의 값을 설정합니다. 필드 이름은 상대 데이터 경로이거나 $data, xfa.datasets.data 또는 $record로 시작하는 표준 데이터 SOM 경로일 수 있습니다. 레코드를 처리하지 않는 패킷에서 $record는 $data 아래 외부 데이터 레코드 요소부터의 경로를 업데이트합니다. 데이터 DOM 클래스 선택기 #dataGroup 및 #dataValue는 숫자 또는 와일드카드 발생 선택기로 그룹 또는 스칼라 데이터 노드를 클래스별 업데이트합니다. $data.Receipt.Detail.[Total_Price <= 200].Description과 같은 단순 FormCalc 스타일 조건자 선택기는 자식 스칼라 값에 따라 일치하는 형제 데이터 노드를 업데이트합니다. datasets 패킷에 xfa:data 또는 접두사 없는 data 요소가 있으면 완전한 XDP 패킷을 허용합니다. 데이터 노드는 로컬 XML 이름으로 일치하므로 비즈니스 데이터 요소가 자체 네임스페이스 접두사를 사용할 수 있습니다. datasets 값 API는 SOM parent 속성도 허용하여 선택한 데이터 노드에서 컨테이너로 올라간 뒤 형제 항목을 업데이트할 수 있습니다(예: $data.Receipt.Detail[0].parent.Tax). $data..Total_Price와 같은 하위 항목 선택기는 현재 datasets 범위 아래에서 일치하는 첫 데이터 노드를 업데이트합니다. $data.Receipt.*.Total_Price와 같은 자식 와일드카드 선택기는 각 직계 자식 분기 아래의 일치하는 데이터 노드를 업데이트함

구문

Delphi

Function DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;

DLL

int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * NewValue);

매개변수

XFAFieldName 작업할 XFA datasets 필드 이름입니다. 상대 필드 경로와 $data..., xfa.datasets.data..., !data..., $record... SOM 루트를 허용합니다. 점 또는 슬래시 구분자를 사용할 수 있고 슬래시 경로는 리터럴 점을 보존하며 점 SOM 경로는 Line\.Item 같은 이스케이프 점을 허용합니다. 반복 노드는 [*] 경로(예: $data.Receipt.Detail[*].Total_Price)로 선택하고 parent는 부모로 올라가며 #dataGroup 및 #dataValue는 그룹과 스칼라를 지정합니다. .[Total_Price <= 200] 같은 조건자는 형제 노드를 필터링하고 $data..Total_Price는 하위를 검색하며 $data.Receipt.*.Total_Price는 모든 직접 자식 분기를 검색합니다

NewValue XFA 필드의 새 값이며, XFAFieldName에 [*], 자식 와일드카드 선택기 또는 조건자 선택기가 포함된 경우 일치하는 모든 데이터 노드에 같은 값이 기록됨

XFAFieldName	작업할 XFA datasets 필드 이름입니다. 상대 필드 경로와 `$data...`, `xfa.datasets.data...`, `!data...`, `$record...` SOM 루트를 허용합니다. 점 또는 슬래시 구분자를 사용할 수 있고 슬래시 경로는 리터럴 점을 보존하며 점 SOM 경로는 `Line\.Item` 같은 이스케이프 점을 허용합니다. 반복 노드는 `[]` 경로(예: `$data.Receipt.Detail[].Total_Price`)로 선택하고 `parent`는 부모로 올라가며 `#dataGroup` 및 `#dataValue`는 그룹과 스칼라를 지정합니다. `.[Total_Price <= 200]` 같은 조건자는 형제 노드를 필터링하고 `$data..Total_Price`는 하위를 검색하며 `$data.Receipt.*.Total_Price`는 모든 직접 자식 분기를 검색합니다
NewValue	XFA 필드의 새 값이며, `XFAFieldName`에 `[*]`, 자식 와일드카드 선택기 또는 조건자 선택기가 포함된 경우 일치하는 모든 데이터 노드에 같은 값이 기록됨