GetXFAFormFieldValueA

Campos de formulario

Descripción

La A final indica el punto de entrada de DLL ANSI (char); la interfaz ActiveX/COM solo expone la forma Unicode. El comportamiento es idéntico a GetXFAFormFieldValue y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual

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

Sintaxis

Delphi

Function DLGetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName: PAnsiChar): PAnsiChar;

DLL

const char * DLGetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName);

Parámetros

XFAFieldName El nombre del campo de conjuntos de datos XFA con el que se trabajará; acepta rutas relativas de campo, las 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 los puntos literales, las rutas SOM delimitadas por puntos aceptan puntos protegidos como Line\.Item, los nodos de datos repetidos se pueden seleccionar con rutas [*] como $data.Receipt.Detail[*].Total_Price, parent puede subir al elemento primario del nodo seleccionado antes de continuar la ruta, los selectores de clase como #dataGroup y #dataValue direccionan grupos y valores escalares de Data DOM, los selectores de predicado sencillos como .[Total_Price > 200] filtran nodos de datos hermanos por el valor escalar secundario, los selectores descendientes como $data..Total_Price buscan bajo el ámbito de conjuntos de datos actual y los selectores comodín secundarios como $data.Receipt.*.Total_Price buscan bajo cada rama secundaria directa

XFAFieldName	El nombre del campo de conjuntos de datos XFA con el que se trabajará; acepta rutas relativas de campo, las 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 los puntos literales, las rutas SOM delimitadas por puntos aceptan puntos protegidos como `Line\.Item`, los nodos de datos repetidos se pueden seleccionar con rutas `[]` como `$data.Receipt.Detail[].Total_Price`, `parent` puede subir al elemento primario del nodo seleccionado antes de continuar la ruta, los selectores de clase como `#dataGroup` y `#dataValue` direccionan grupos y valores escalares de Data DOM, los selectores de predicado sencillos como `.[Total_Price > 200]` filtran nodos de datos hermanos por el valor escalar secundario, los selectores descendientes como `$data..Total_Price` buscan bajo el ámbito de conjuntos de datos actual y los selectores comodín secundarios como `$data.Receipt.*.Total_Price` buscan bajo cada rama secundaria directa