SetXFAFormFieldValueA

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 SetXFAFormFieldValue, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Legt den Wert des angegebenen XFA-Formularfelds fest. 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 aktualisiert $record Pfade ab dem äußeren Datensatzelement unter $data. Daten-DOM-Klassenselektoren #dataGroup und #dataValue aktualisieren gruppierte oder skalare Datenknoten nach Klasse mit numerischen oder Platzhalter-Vorkommensselektoren. Einfache Prädikatselektoren im FormCalc-Stil wie $data.Receipt.Detail.[Total_Price <= 200].Description aktualisieren passende gleichgeordnete Datenknoten anhand des skalaren Werts eines untergeordneten Knotens. Vollständige XDP-Pakete werden akzeptiert, wenn das datasets-Paket entweder ein Element xfa:data oder ein Element data ohne Präfix enthält. Datenknoten werden anhand des lokalen XML-Namens abgeglichen, sodass Geschäftsdaten-Elemente ein eigenes Namespace-Präfix verwenden können. Die datasets-Wert-APIs akzeptieren außerdem die SOM-Eigenschaft parent, um von einem ausgewählten Datenknoten zu dessen Container aufzusteigen, bevor ein gleichgeordneter Knoten aktualisiert wird, zum Beispiel $data.Receipt.Detail[0].parent.Tax. Nachkommenselektoren wie $data..Total_Price aktualisieren den ersten passenden Datenknoten unterhalb des aktuellen datasets-Gültigkeitsbereichs. Untergeordnete Platzhalterselektoren wie $data.Receipt.*.Total_Price aktualisieren passende Datenknoten unter jedem direkten untergeordneten Zweig.

Syntax

Delphi

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

DLL

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

Parameter

XFAFieldName Der zu bearbeitende XFA-datasets-Feldname; akzeptiert relative Feldpfade sowie SOM-Wurzeln der Form $data..., xfa.datasets.data..., !data... und $record..., jeweils mit Punkt- oder Schrägstrichtrennzeichen vor oder nach der Wurzel; durch Schrägstriche getrennte Pfade bewahren Punkte als Literale, durch Punkte getrennte SOM-Pfade akzeptieren maskierte Punkte wie Line\.Item, wiederholte Datenknoten lassen sich mit [*]-Pfaden wie $data.Receipt.Detail[*].Total_Price auswählen, parent kann zum übergeordneten Knoten des ausgewählten Knotens aufsteigen, bevor der Pfad fortgesetzt wird, Klassenselektoren wie #dataGroup und #dataValue adressieren Gruppen und skalare Werte im Daten-DOM, einfache Prädikatselektoren wie .[Total_Price <= 200] filtern gleichgeordnete Datenknoten anhand des skalaren Werts eines untergeordneten Knotens, Nachkommenselektoren wie $data..Total_Price durchsuchen den Bereich unterhalb des aktuellen datasets-Gültigkeitsbereichs, und untergeordnete Platzhalterselektoren wie $data.Receipt.*.Total_Price durchsuchen jeden direkten untergeordneten Zweig

NewValue Der neue Wert für das XFA-Feld; wenn XFAFieldName [*], einen untergeordneten Platzhalterselektor oder einen Prädikatselektor enthält, wird derselbe Wert in jeden passenden Datenknoten geschrieben

XFAFieldName	Der zu bearbeitende XFA-datasets-Feldname; akzeptiert relative Feldpfade sowie SOM-Wurzeln der Form `$data...`, `xfa.datasets.data...`, `!data...` und `$record...`, jeweils mit Punkt- oder Schrägstrichtrennzeichen vor oder nach der Wurzel; durch Schrägstriche getrennte Pfade bewahren Punkte als Literale, durch Punkte getrennte SOM-Pfade akzeptieren maskierte Punkte wie `Line\.Item`, wiederholte Datenknoten lassen sich mit `[]`-Pfaden wie `$data.Receipt.Detail[].Total_Price` auswählen, `parent` kann zum übergeordneten Knoten des ausgewählten Knotens aufsteigen, bevor der Pfad fortgesetzt wird, Klassenselektoren wie `#dataGroup` und `#dataValue` adressieren Gruppen und skalare Werte im Daten-DOM, einfache Prädikatselektoren wie `.[Total_Price <= 200]` filtern gleichgeordnete Datenknoten anhand des skalaren Werts eines untergeordneten Knotens, Nachkommenselektoren wie `$data..Total_Price` durchsuchen den Bereich unterhalb des aktuellen datasets-Gültigkeitsbereichs, und untergeordnete Platzhalterselektoren wie `$data.Receipt.*.Total_Price` durchsuchen jeden direkten untergeordneten Zweig
NewValue	Der neue Wert für das XFA-Feld; wenn `XFAFieldName` `[*]`, einen untergeordneten Platzhalterselektor oder einen Prädikatselektor enthält, wird derselbe Wert in jeden passenden Datenknoten geschrieben