SetXFAFormFieldValue

Campos de formulário

Descrição

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 que comece por $data, xfa.datasets.data ou $record. Em pacotes que não processam registos, $record atualiza caminhos a partir do elemento exterior do registo de dados sob $data. Os seletores de classe Data DOM #dataGroup e #dataValue atualizam nós de dados agrupados ou escalares por classe com seletores de ocorrências 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 subordinado. 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 comparados pelo nome XML local, pelo que os elementos de dados empresariais podem utilizar o seu próprio prefixo de namespace. 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 de descendentes, como $data..Total_Price, atualizam o primeiro nó de dados correspondente sob o âmbito atual dos conjuntos de dados. Os seletores universais de elementos subordinados, como $data.Receipt.*.Total_Price, atualizam os nós de dados correspondentes sob cada ramo subordinado direto

Sintaxe

Delphi

Function TPDFlib.SetXFAFormFieldValue(Const XFAFieldName, NewValue: WideString): Integer;

ActiveX

Function PDFlib::SetXFAFormFieldValue(XFAFieldName As String, NewValue As String) As Long

DLL

int DLSetXFAFormFieldValue(int InstanceID, const wchar_t * XFAFieldName, const wchar_t * NewValue);

Parâmetros

XFAFieldName O nome do campo dos conjuntos de dados XFA com o qual trabalhar; 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 pontos literais, os caminhos SOM delimitados por pontos aceitam pontos escapados como Line\.Item, os nós de dados repetidos podem ser selecionados com caminhos [*] como $data.Receipt.Detail[*].Total_Price, parent pode subir ao elemento principal do nó selecionado antes de continuar o caminho, os seletores de classe como #dataGroup e #dataValue endereçam grupos do Data DOM e valores escalares, os seletores de predicado simples como .[Total_Price <= 200] filtram nós de dados irmãos pelo valor escalar subordinado, os seletores de descendentes como $data..Total_Price pesquisam abaixo do âmbito atual dos conjuntos de dados e os seletores universais subordinados como $data.Receipt.*.Total_Price pesquisam abaixo de cada ramo subordinado direto

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

XFAFieldName	O nome do campo dos conjuntos de dados XFA com o qual trabalhar; 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 pontos literais, os caminhos SOM delimitados por pontos aceitam pontos escapados como `Line\.Item`, os nós de dados repetidos podem ser selecionados com caminhos `[]` como `$data.Receipt.Detail[].Total_Price`, `parent` pode subir ao elemento principal do nó selecionado antes de continuar o caminho, os seletores de classe como `#dataGroup` e `#dataValue` endereçam grupos do Data DOM e valores escalares, os seletores de predicado simples como `.[Total_Price <= 200]` filtram nós de dados irmãos pelo valor escalar subordinado, os seletores de descendentes como `$data..Total_Price` pesquisam abaixo do âmbito atual dos conjuntos de dados e os seletores universais subordinados como `$data.Receipt.*.Total_Price` pesquisam abaixo de cada ramo subordinado direto
NewValue	O novo valor do campo XFA; quando `XFAFieldName` contém `[*]`, um seletor universal de elementos subordinados ou um seletor de predicado, o mesmo valor é escrito em todos os nós de dados correspondentes