GetXFAFormFieldValueA

Campos de formulario

Descripción

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

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 DLGetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName: PAnsiChar): PAnsiChar;

DLL

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

Parámetros

XFAFieldNameEl 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