SetXFAFormFieldValueA

Campos de formulário

Descrição

O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de SetXFAFormFieldValue e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode

Define o valor do campo de formulário XFA especificado. O nome do campo pode ser um caminho de dados relativo ou um caminho SOM de dados padrão iniciado por $data, xfa.datasets.data ou $record. Em pacotes que não processam registos, $record atualiza os caminhos a partir do elemento de registo de dados exterior sob $data. Os seletores de classe do DOM de dados #dataGroup e #dataValue atualizam nós de dados agrupados ou escalares por classe, com seletores de ocorrência numéricos ou universais. Os seletores de predicado simples ao estilo FormCalc, como $data.Receipt.Detail.[Total_Price <= 200].Description, atualizam nós de dados irmãos correspondentes segundo o valor escalar de um filho. São aceites pacotes XDP completos quando o pacote de conjuntos de dados contém um elemento xfa:data ou data sem prefixo. Os nós de dados são identificados pelo nome XML local, pelo que os elementos de dados de negócio podem utilizar o seu próprio prefixo de espaço de nomes. As APIs de valores dos conjuntos de dados também aceitam a propriedade SOM parent para subir de um nó de dados selecionado para o respetivo contentor antes de atualizar um irmão, por exemplo $data.Receipt.Detail[0].parent.Tax. Os seletores descendentes, como $data..Total_Price, atualizam o primeiro nó de dados correspondente abaixo do âmbito atual dos conjuntos de dados. Os seletores universais de filhos, como $data.Receipt.*.Total_Price, atualizam os nós de dados correspondentes sob cada ramo filho direto

Sintaxe

Delphi

Function DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;

DLL

int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * NewValue);

Parâmetros

XFAFieldName O nome do campo dos conjuntos de dados XFA a utilizar; aceita caminhos de campo relativos, raízes SOM $data..., xfa.datasets.data..., !data... e $record..., com delimitadores de ponto ou barra antes ou depois da raiz; os caminhos delimitados por barras preservam os pontos literais, os caminhos SOM delimitados por pontos aceitam pontos com escape, como Line\.Item, os nós de dados repetidos podem ser selecionados com caminhos [*], como $data.Receipt.Detail[*].Total_Price, parent permite subir para o elemento ascendente do nó selecionado antes de continuar o caminho, seletores de classe como #dataGroup e #dataValue endereçam grupos e valores escalares do DOM de dados, seletores de predicado simples como .[Total_Price <= 200] filtram nós de dados irmãos pelo valor escalar de um filho, seletores descendentes como $data..Total_Price pesquisam abaixo do âmbito atual dos conjuntos de dados e seletores universais de filhos como $data.Receipt.*.Total_Price pesquisam sob cada ramo filho direto

NewValue O novo valor do campo XFA; quando XFAFieldName contém [*], um seletor universal de filhos ou um seletor de predicado, o mesmo valor é gravado em todos os nós de dados correspondentes

XFAFieldName	O nome do campo dos conjuntos de dados XFA a utilizar; aceita caminhos de campo relativos, raízes SOM `$data...`, `xfa.datasets.data...`, `!data...` e `$record...`, com delimitadores de ponto ou barra antes ou depois da raiz; os caminhos delimitados por barras preservam os pontos literais, os caminhos SOM delimitados por pontos aceitam pontos com escape, como `Line\.Item`, os nós de dados repetidos podem ser selecionados com caminhos `[]`, como `$data.Receipt.Detail[].Total_Price`, `parent` permite subir para o elemento ascendente do nó selecionado antes de continuar o caminho, seletores de classe como `#dataGroup` e `#dataValue` endereçam grupos e valores escalares do DOM de dados, seletores de predicado simples como `.[Total_Price <= 200]` filtram nós de dados irmãos pelo valor escalar de um filho, seletores descendentes como `$data..Total_Price` pesquisam abaixo do âmbito atual dos conjuntos de dados e seletores universais de filhos como `$data.Receipt.*.Total_Price` pesquisam sob cada ramo filho direto
NewValue	O novo valor do campo XFA; quando `XFAFieldName` contém `[*]`, um seletor universal de filhos ou um seletor de predicado, o mesmo valor é gravado em todos os nós de dados correspondentes