SetXFAFormFieldValueA
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 SetXFAFormFieldValue y los argumentos de cadena se interpretan con la página de códigos SetAnsiMode actual
Establece el valor del campo de formulario XFA especificado. El nombre del campo puede ser una ruta de datos relativa o una ruta SOM de datos estándar que comience por $data, xfa.datasets.data o $record. En paquetes sin procesamiento de registros, $record actualiza las rutas desde el elemento exterior del registro de datos situado bajo $data. Los selectores de clase DOM de datos #dataGroup y #dataValue actualizan nodos de datos agrupados o escalares por clase mediante selectores de aparición numéricos o comodín. Los selectores de predicado sencillos al estilo FormCalc, como $data.Receipt.Detail.[Total_Price <= 200].Description, actualizan los nodos de datos hermanos coincidentes según el valor escalar de un hijo. Se aceptan paquetes XDP completos cuando el paquete datasets contiene un elemento 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 utilizar su propio prefijo de espacio de nombres. Las API de valores datasets también admiten la propiedad SOM parent para ascender desde un nodo de datos seleccionado hasta su contenedor antes de actualizar un hermano, por ejemplo $data.Receipt.Detail[0].parent.Tax. Los selectores de descendientes, como $data..Total_Price, actualizan el primer nodo de datos coincidente bajo el ámbito datasets actual. Los selectores comodín de hijos, como $data.Receipt.*.Total_Price, actualizan los nodos de datos coincidentes bajo cada rama hija directa
Sintaxis
Delphi
Function DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;
DLL
int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * NewValue);
Parámetros
| XFAFieldName | Nombre de campo XFA; admite rutas relativas y raíces $data..., xfa.datasets.data..., !data..., $record..., puntos o barras; las barras conservan puntos y SOM acepta Line\.Item; repetidos con [*] como $data.Receipt.Detail[*].Total_Price; parent sube; #dataGroup/#dataValue seleccionan clases; .[Total_Price <= 200] filtra; $data..Total_Price busca descendientes y $data.Receipt.*.Total_Price hijos |
|---|---|
| NewValue | El nuevo valor del campo XFA; cuando XFAFieldName contiene [*], un selector comodín de hijos o un selector de predicado, el mismo valor se escribe en todos los nodos de datos coincidentes |