GetXFAFormFieldValue

Campos de formulário

Descrição

Devolve 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 sem processamento de registos, $record é resolvido a partir do elemento exterior do registo de dados sob $data. Os seletores de classes DOM de dados #dataGroup e #dataValue selecionam nós de dados agrupados ou escalares por classe, com seletores numéricos ou universais de ocorrências. Os seletores de predicados simples ao estilo de FormCalc, como $data.Receipt.Detail.[Total_Price > 200].Description, selecionam nós de dados irmãos correspondentes pelo valor escalar 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 comparados pelo nome XML local, pelo que os elementos de dados empresariais 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 seu contentor antes de ler um irmão, por exemplo $data.Receipt.Detail[1].parent.Tax. Os seletores descendentes, como $data..Total_Price, resolvem o primeiro nó de dados correspondente sob o âmbito atual dos conjuntos de dados. Os seletores universais de filhos, como $data.Receipt.*.Total_Price, devolvem os nós de dados correspondentes sob cada ramo filho direto

Sintaxe

Delphi

Function TPDFlib.GetXFAFormFieldValue(Const XFAFieldName: WideString): WideString;

ActiveX

Function PDFlib::GetXFAFormFieldValue(XFAFieldName As String) As String

DLL

const wchar_t * DLGetXFAFormFieldValue(int InstanceID, const wchar_t * XFAFieldName);

Parâmetros

XFAFieldName O nome do campo dos conjuntos de dados XFA a utilizar; aceita caminhos de campos 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 conservam 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 pode subir para o nó 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 de elementos subordinados, como $data.Receipt.*.Total_Price, pesquisam abaixo de cada ramo subordinado direto

XFAFieldName	O nome do campo dos conjuntos de dados XFA a utilizar; aceita caminhos de campos 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 conservam 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` pode subir para o nó 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 de elementos subordinados, como `$data.Receipt.*.Total_Price`, pesquisam abaixo de cada ramo subordinado direto