SetXFAFormFieldValue

Form alanları

Açıklama

Belirtilen XFA form alanının değerini ayarlar. Alan adı göreli veri yolu veya $data, xfa.datasets.data ya da $record ile başlayan standart veri SOM yolu olabilir. Kayıt işlemeyen paketlerde $record, dış veri kaydı öğesinden $data altındaki yolları günceller. Data DOM sınıf seçicileri #dataGroup ve #dataValue, sayısal veya joker oluşum seçicileriyle gruplanmış ya da skaler veri düğümlerini sınıfa göre günceller. $data.Receipt.Detail.[Total_Price <= 200].Description gibi basit FormCalc tarzı koşul seçicileri, alt skaler değere göre eşleşen kardeş veri düğümlerini günceller. Datasets paketi xfa:data veya öneksiz data öğesi içerdiğinde eksiksiz XDP paketleri kabul edilir. Veri düğümleri yerel XML adına göre eşleştirilir; bu nedenle iş verisi öğeleri kendi ad alanı öneklerini kullanabilir. Datasets değer API'leri, seçili veri düğümünden kapsayıcısına çıkıp bir kardeşi güncellemek için SOM parent özelliğini de kabul eder; örneğin $data.Receipt.Detail[0].parent.Tax. $data..Total_Price gibi alt öğe seçicileri, geçerli datasets kapsamının altındaki ilk eşleşen veri düğümünü günceller. $data.Receipt.*.Total_Price gibi alt joker seçicileri, her doğrudan alt dalın altındaki eşleşen veri düğümlerini günceller

Sözdizimi

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);

Parametreler

XFAFieldName Üzerinde çalışılacak XFA datasets alan adı; göreli alan yollarını, $data..., xfa.datasets.data..., !data... ve $record... SOM köklerini, kökten önce veya sonra nokta ya da eğik çizgi sınırlayıcılarını kabul eder; eğik çizgi sınırlı yollar değişmez noktaları korur, nokta sınırlı SOM yolları Line\.Item gibi kaçışlanmış noktaları kabul eder, yinelenen veri düğümleri [*] yollarıyla seçilebilir; örneğin $data.Receipt.Detail[*].Total_Price, parent yola devam etmeden önce seçilen düğümün üstüne çıkabilir, #dataGroup ve #dataValue gibi sınıf seçiciler Data DOM gruplarını ve skaler değerleri adresler, .[Total_Price <= 200] gibi basit koşul seçicileri kardeş veri düğümlerini alt skaler değere göre süzer, $data..Total_Price gibi alt öğe seçicileri geçerli datasets kapsamının altında arama yapar ve $data.Receipt.*.Total_Price gibi alt joker seçiciler her doğrudan alt dalın altında arama yapar

NewValue XFA alanının yeni değeri; XFAFieldName değeri [*], bir alt joker seçicisi veya koşul seçicisi içerdiğinde aynı değer eşleşen her veri düğümüne yazılır

XFAFieldName	Üzerinde çalışılacak XFA datasets alan adı; göreli alan yollarını, `$data...`, `xfa.datasets.data...`, `!data...` ve `$record...` SOM köklerini, kökten önce veya sonra nokta ya da eğik çizgi sınırlayıcılarını kabul eder; eğik çizgi sınırlı yollar değişmez noktaları korur, nokta sınırlı SOM yolları `Line\.Item` gibi kaçışlanmış noktaları kabul eder, yinelenen veri düğümleri `[]` yollarıyla seçilebilir; örneğin `$data.Receipt.Detail[].Total_Price`, `parent` yola devam etmeden önce seçilen düğümün üstüne çıkabilir, `#dataGroup` ve `#dataValue` gibi sınıf seçiciler Data DOM gruplarını ve skaler değerleri adresler, `.[Total_Price <= 200]` gibi basit koşul seçicileri kardeş veri düğümlerini alt skaler değere göre süzer, `$data..Total_Price` gibi alt öğe seçicileri geçerli datasets kapsamının altında arama yapar ve `$data.Receipt.*.Total_Price` gibi alt joker seçiciler her doğrudan alt dalın altında arama yapar
NewValue	XFA alanının yeni değeri; `XFAFieldName` değeri `[*]`, bir alt joker seçicisi veya koşul seçicisi içerdiğinde aynı değer eşleşen her veri düğümüne yazılır