GetXFAFormFieldValue

Campos de formulario

Descripción

Devuelve el valor del campo de formulario XFA especificado. El nombre de campo puede ser una ruta de datos relativa o una ruta SOM de datos estándar que empieza con $data, xfa.datasets.data o $record. En paquetes que no procesan registros, $record se resuelve desde el elemento de registro de datos externo situado debajo de $data. Los selectores de clase de Data DOM #dataGroup y #dataValue seleccionan nodos de datos agrupados o escalares por clase con selectores de ocurrencia numéricos o comodín. Los selectores de predicado simples de estilo FormCalc, como $data.Receipt.Detail.[Total_Price > 200].Description, seleccionan nodos de datos hermanos coincidentes por valor escalar secundario. Se aceptan paquetes XDP completos cuando el paquete de conjuntos de datos contiene xfa:data o un elemento data sin prefijo. Los nodos de datos se comparan por nombre XML local, por lo que los elementos de datos empresariales pueden usar su propio prefijo de espacio de nombres. Las API de valores de conjuntos de datos también aceptan la propiedad SOM parent para subir desde un nodo de datos seleccionado hasta su contenedor antes de leer un hermano, por ejemplo $data.Receipt.Detail[1].parent.Tax. Los selectores de descendientes, como $data..Total_Price, resuelven el primer nodo de datos coincidente bajo el ámbito actual de conjuntos de datos. Los selectores comodín secundarios, como $data.Receipt.*.Total_Price, devuelven nodos de datos coincidentes bajo cada rama secundaria directa

Sintaxis

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);

Parámetros

XFAFieldName El nombre de campo de conjuntos de datos XFA con el que se trabajará; acepta rutas de campo relativas, raíces SOM $data..., xfa.datasets.data..., !data... y $record..., con delimitadores de punto o barra antes o después de la raíz; las rutas delimitadas por barras conservan puntos literales, las rutas SOM delimitadas por puntos aceptan puntos escapados como Line\.Item, los nodos de datos repetidos pueden seleccionarse con rutas [*] como $data.Receipt.Detail[*].Total_Price, parent puede subir al elemento principal del nodo seleccionado antes de continuar la ruta, los selectores de clase como #dataGroup y #dataValue dirigen a grupos Data DOM y valores escalares, los selectores de predicado simples como .[Total_Price > 200] filtran nodos de datos hermanos por valor escalar secundario, los selectores descendientes como $data..Total_Price buscan bajo el ámbito actual de conjuntos de datos, y los selectores comodín secundarios como $data.Receipt.*.Total_Price buscan bajo cada rama secundaria directa

XFAFieldName	El nombre de campo de conjuntos de datos XFA con el que se trabajará; acepta rutas de campo relativas, raíces SOM `$data...`, `xfa.datasets.data...`, `!data...` y `$record...`, con delimitadores de punto o barra antes o después de la raíz; las rutas delimitadas por barras conservan puntos literales, las rutas SOM delimitadas por puntos aceptan puntos escapados como `Line\.Item`, los nodos de datos repetidos pueden seleccionarse con rutas `[]` como `$data.Receipt.Detail[].Total_Price`, `parent` puede subir al elemento principal del nodo seleccionado antes de continuar la ruta, los selectores de clase como `#dataGroup` y `#dataValue` dirigen a grupos Data DOM y valores escalares, los selectores de predicado simples como `.[Total_Price > 200]` filtran nodos de datos hermanos por valor escalar secundario, los selectores descendientes como `$data..Total_Price` buscan bajo el ámbito actual de conjuntos de datos, y los selectores comodín secundarios como `$data.Receipt.*.Total_Price` buscan bajo cada rama secundaria directa