GetXFAFormFieldValue
表单字段
描述
返回指定 XFA 表单字段的值。字段名称可以是相对数据路径,或以 $data、xfa.datasets.data 或 $record 开头的标准数据 SOM 路径。在非记录处理数据包中,$record 从 $data 下的外层数据记录元素解析。数据 DOM 类选择器 #dataGroup 和 #dataValue 通过带数字或通配符出现选择器的类来选择分组或标量数据节点。简单的 FormCalc 样式谓词选择器,例如 $data.Receipt.Detail.[Total_Price > 200].Description,按子标量值选择匹配的同级数据节点。数据集数据包包含 xfa:data 或无前缀 data 元素时,接受完整 XDP 数据包。数据节点按本地 XML 名称匹配,因此业务数据元素可使用自己的命名空间前缀。数据集值 API 还接受 SOM parent 属性,可在读取同级节点前从所选数据节点向上到其容器,例如 $data.Receipt.Detail[1].parent.Tax。如 $data..Total_Price 的后代选择器会解析当前数据集作用域下第一个匹配的数据节点。如 $data.Receipt.*.Total_Price 的子通配符选择器会返回每个直接子分支下匹配的数据节点
语法
Delphi
Function TPDFlib.GetXFAFormFieldValue(Const XFAFieldName: WideString): WideString;
ActiveX
Function PDFlib::GetXFAFormFieldValue(XFAFieldName As String) As String
DLL
const wchar_t * DLGetXFAFormFieldValue(int InstanceID, const wchar_t * XFAFieldName);
参数
| XFAFieldName | 要使用的 XFA 数据集字段名称,接受相对字段路径、$data...、xfa.datasets.data...、!data... 和 $record... SOM 根,根之前或之后可使用点或斜杠分隔符;斜杠分隔路径保留字面句点,点分隔 SOM 路径接受转义句点,例如 Line\.Item;可使用 [*] 路径选择重复数据节点,例如 $data.Receipt.Detail[*].Total_Price;parent 可先上溯到所选节点的父级,再继续解析路径;类选择器如 #dataGroup 和 #dataValue 用于寻址 Data DOM 组和标量值;简单谓词选择器如 .[Total_Price > 200] 按子标量值筛选同级数据节点;后代选择器如 $data..Total_Price 在当前数据集范围下搜索;子通配符选择器如 $data.Receipt.*.Total_Price 在每个直接子分支下搜索 |
|---|