SetXFAFormFieldValueA
Form alanları
Açıklama
Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış SetXFAFormFieldValue ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır
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 DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;
DLL
int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * 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 |