SetXFAFormFieldValueA

Campos de formulario

Descripción

La A final indica el punto de entrada ANSI (char) de la DLL; 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 actual de SetAnsiMode

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 comienza con $data, xfa.datasets.data o $record. En paquetes sin procesamiento de registros, $record actualiza rutas desde el elemento de registro de datos externo situado debajo de $data. Los selectores de clase Data DOM #dataGroup y #dataValue actualizan nodos de datos agrupados o escalares por clase con selectores de ocurrencia numéricos o comodín. Los selectores predicados simples de estilo FormCalc, como $data.Receipt.Detail.[Total_Price <= 200].Description, actualizan nodos de datos hermanos coincidentes según el valor escalar secundario. 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 hacen coincidir por el nombre XML local, de modo que los elementos de datos empresariales pueden usar su propio prefijo de espacio de nombres. Las API de valores de datasets también aceptan la propiedad SOM parent para subir desde un nodo de datos seleccionado hasta su contenedor antes de actualizar un elemento hermano, por ejemplo $data.Receipt.Detail[0].parent.Tax. Los selectores descendientes, como $data..Total_Price, actualizan el primer nodo de datos coincidente debajo del ámbito datasets actual. Los selectores comodín secundarios, como $data.Receipt.*.Total_Price, actualizan nodos de datos coincidentes debajo de cada rama secundaria 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 El nombre del 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 los puntos literales, las rutas SOM delimitadas por puntos aceptan puntos escapados como Line\.Item, los nodos de datos repetidos se pueden seleccionar con rutas [*] como $data.Receipt.Detail[*].Total_Price, parent puede subir al nodo padre del nodo seleccionado antes de continuar la ruta, los selectores de clase como #dataGroup y #dataValue se dirigen a grupos y valores escalares de Data DOM, 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 debajo del ámbito actual de conjuntos de datos y los selectores comodín secundarios como $data.Receipt.*.Total_Price buscan debajo de cada rama secundaria directa

NewValue El nuevo valor para el campo XFA; cuando XFAFieldName contiene [*], un selector comodín secundario o un selector de predicado, se escribe el mismo valor en cada nodo de datos coincidente

XFAFieldName	El nombre del 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 los puntos literales, las rutas SOM delimitadas por puntos aceptan puntos escapados como `Line\.Item`, los nodos de datos repetidos se pueden seleccionar con rutas `[]` como `$data.Receipt.Detail[].Total_Price`, `parent` puede subir al nodo padre del nodo seleccionado antes de continuar la ruta, los selectores de clase como `#dataGroup` y `#dataValue` se dirigen a grupos y valores escalares de Data DOM, 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 debajo del ámbito actual de conjuntos de datos y los selectores comodín secundarios como `$data.Receipt.*.Total_Price` buscan debajo de cada rama secundaria directa
NewValue	El nuevo valor para el campo XFA; cuando `XFAFieldName` contiene `[*]`, un selector comodín secundario o un selector de predicado, se escribe el mismo valor en cada nodo de datos coincidente