GetXFAFormFieldValueA

Formularfelder

Beschreibung

Das abschließende A bezeichnet den ANSI-Einstiegspunkt (char) der DLL; die ActiveX/COM-Schnittstelle stellt nur die Unicode-Form bereit. Das Verhalten entspricht GetXFAFormFieldValue, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Gibt den Wert des angegebenen XFA-Formularfelds zurück. Der Feldname kann ein relativer Datenpfad oder ein standardmäßiger Daten-SOM-Pfad sein, der mit $data, xfa.datasets.data oder $record beginnt. In Paketen ohne Datensatzverarbeitung wird $record vom äußeren Datensatzelement unterhalb von $data aufgelöst. Data-DOM-Klassenselektoren #dataGroup und #dataValue wählen gruppierte beziehungsweise skalare Datenknoten anhand der Klasse und mit numerischen oder Platzhalter-Vorkommensselektoren aus. Einfache Prädikatselektoren im FormCalc-Stil wie $data.Receipt.Detail.[Total_Price > 200].Description wählen passende benachbarte Datenknoten anhand des skalaren Werts eines untergeordneten Elements aus. Vollständige XDP-Pakete werden akzeptiert, wenn das datasets-Paket entweder ein xfa:data-Element oder ein nicht präfixiertes data-Element enthält. Datenknoten werden anhand ihres lokalen XML-Namens abgeglichen, sodass Geschäftsdaten eigene Namespacepräfixe verwenden dürfen. Die datasets-Wert-APIs akzeptieren außerdem die SOM-Eigenschaft parent, um von einem ausgewählten Datenknoten zu dessen Container aufzusteigen und anschließend ein benachbartes Element zu lesen, beispielsweise $data.Receipt.Detail[1].parent.Tax. Nachkommenselektoren wie $data..Total_Price lösen den ersten passenden Datenknoten unterhalb des aktuellen datasets-Bereichs auf. Untergeordnete Platzhalterselektoren wie $data.Receipt.*.Total_Price geben passende Datenknoten unter jedem direkten untergeordneten Zweig zurück.

Syntax

Delphi

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

DLL

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

Parameter

XFAFieldName Der zu bearbeitende XFA-datasets-Feldname; akzeptiert relative Feldpfade, $data..., xfa.datasets.data..., !data... und $record... als SOM-Wurzeln mit Punkt- oder Schrägstrichtrennzeichen vor oder nach der Wurzel; durch Schrägstriche getrennte Pfade bewahren literale Punkte, durch Punkte getrennte SOM-Pfade akzeptieren maskierte Punkte wie Line\.Item, wiederholte Datenknoten können mit [*]-Pfaden wie $data.Receipt.Detail[*].Total_Price ausgewählt werden, parent kann zum übergeordneten Knoten des ausgewählten Knotens aufsteigen, bevor der Pfad fortgesetzt wird, Klassenselektoren wie #dataGroup und #dataValue adressieren Data-DOM-Gruppen und skalare Werte, einfache Prädikatselektoren wie .[Total_Price > 200] filtern benachbarte Datenknoten anhand des skalaren Werts eines untergeordneten Elements, Nachkommenselektoren wie $data..Total_Price suchen unterhalb des aktuellen datasets-Bereichs, und untergeordnete Platzhalterselektoren wie $data.Receipt.*.Total_Price suchen unter jedem direkten untergeordneten Zweig

XFAFieldName	Der zu bearbeitende XFA-datasets-Feldname; akzeptiert relative Feldpfade, `$data...`, `xfa.datasets.data...`, `!data...` und `$record...` als SOM-Wurzeln mit Punkt- oder Schrägstrichtrennzeichen vor oder nach der Wurzel; durch Schrägstriche getrennte Pfade bewahren literale Punkte, durch Punkte getrennte SOM-Pfade akzeptieren maskierte Punkte wie `Line\.Item`, wiederholte Datenknoten können mit `[]`-Pfaden wie `$data.Receipt.Detail[].Total_Price` ausgewählt werden, `parent` kann zum übergeordneten Knoten des ausgewählten Knotens aufsteigen, bevor der Pfad fortgesetzt wird, Klassenselektoren wie `#dataGroup` und `#dataValue` adressieren Data-DOM-Gruppen und skalare Werte, einfache Prädikatselektoren wie `.[Total_Price > 200]` filtern benachbarte Datenknoten anhand des skalaren Werts eines untergeordneten Elements, Nachkommenselektoren wie `$data..Total_Price` suchen unterhalb des aktuellen datasets-Bereichs, und untergeordnete Platzhalterselektoren wie `$data.Receipt.*.Total_Price` suchen unter jedem direkten untergeordneten Zweig