GetXFAFormFieldValueA

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 GetXFAFormFieldValue e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode

Devolve o valor do campo de formulário XFA especificado. O nome pode ser um caminho de dados relativo ou um caminho SOM padrão iniciado por $data, xfa.datasets.data ou $record. Em pacotes sem processamento de registos, $record é resolvido a partir do elemento de registo exterior abaixo de $data. Os seletores de classe DOM #dataGroup e #dataValue selecionam nós agrupados ou escalares por classe, com seletores de ocorrência numéricos ou universais. Predicados simples ao estilo FormCalc, como $data.Receipt.Detail.[Total_Price > 200].Description, selecionam nós irmãos pelo valor escalar de um filho. São aceites pacotes XDP completos quando datasets contém xfa:data ou um elemento data sem prefixo. Os nós são comparados pelo nome XML local. As APIs também aceitam a propriedade SOM parent para subir ao contentor antes de ler um irmão, por exemplo $data.Receipt.Detail[1].parent.Tax. Seletores descendentes como $data..Total_Price resolvem o primeiro nó abaixo do âmbito atual. Seletores universais de filhos como $data.Receipt.*.Total_Price devolvem nós em cada ramo filho direto.

Sintaxe

Delphi

Function DLGetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName: PAnsiChar): PAnsiChar;

DLL

const char * DLGetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName);

Parâmetros

XFAFieldNameNome do campo datasets XFA; aceita caminhos relativos, raízes SOM $data..., xfa.datasets.data..., !data... e $record..., com separadores de ponto ou barra antes ou depois da raiz; caminhos com barras preservam pontos literais e caminhos SOM com pontos aceitam pontos escapados como Line\.Item; nós repetidos podem ser selecionados por caminhos [*], como $data.Receipt.Detail[*].Total_Price; parent sobe ao pai antes de continuar; seletores de classe como #dataGroup e #dataValue endereçam grupos e valores escalares; predicados simples como .[Total_Price > 200] filtram irmãos por valor escalar de um filho; seletores descendentes como $data..Total_Price pesquisam abaixo do âmbito atual; e seletores universais de filhos como $data.Receipt.*.Total_Price pesquisam em todos os ramos filhos diretos