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

XFAFieldNameNombre 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
NewValueEl 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