SetXFAFormFieldValue

حقول النماذج

الوصف

يضبط قيمة حقل نموذج XFA المحدد. وقد يكون اسم الحقل مسار بيانات نسبيًا أو مسار SOM قياسيًا للبيانات يبدأ بـ $data أو xfa.datasets.data أو $record. وفي الحزم غير المعالجة كسجلات يحدّث $record المسارات من عنصر سجل البيانات الخارجي أسفل $data. وتحدّث محددات أصناف Data DOM‏ #dataGroup و#dataValue عقد البيانات المجمعة أو العددية بالصنف مع محددات وقوع رقمية أو بنمط شامل. وتحدّث محددات المسند البسيطة بنمط FormCalc مثل $data.Receipt.Detail.[Total_Price <= 200].Description عقد البيانات الشقيقة المطابقة حسب قيمة ابنها العددي. وتُقبل حزم XDP الكاملة عندما تتضمن حزمة datasets إما xfa:data أو عنصر data بلا بادئة. وتُطابَق عقد البيانات باسم XML المحلي، لذا يمكن لعناصر بيانات الأعمال استخدام بادئة نطاق أسمائها الخاصة. وتقبل واجهات قيمة datasets أيضًا خاصية SOM‏ parent للتسلق من عقدة بيانات مختارة إلى حاويتها قبل تحديث شقيقة، مثل $data.Receipt.Detail[0].parent.Tax. وتحدّث محددات السلالة مثل $data..Total_Price أول عقدة بيانات مطابقة أسفل نطاق datasets الحالي. وتحدّث محددات الأبناء الشاملة مثل $data.Receipt.*.Total_Price عقد البيانات المطابقة أسفل كل فرع ابن مباشر

الصيغة

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

المعاملات

XFAFieldName اسم حقل datasets في XFA المطلوب التعامل معه؛ يقبل مسارات حقول نسبية وجذور SOM‏ $data... وxfa.datasets.data... و!data... و$record...، بفواصل نقطية أو مائلة قبل الجذر أو بعده؛ وتحافظ المسارات المحددة بالمائل على النقاط الحرفية، وتقبل مسارات SOM النقطية نقاطًا مُهرَّبة مثل Line\.Item، ويمكن اختيار عقد البيانات المتكررة بمسارات [*] مثل $data.Receipt.Detail[*].Total_Price، ويمكن لـ parent التسلق إلى أب العقدة المختارة قبل متابعة المسار، وتخاطب محددات الأصناف مثل #dataGroup و#dataValue مجموعات Data DOM والقيم العددية، وتصفّي محددات المسند البسيطة مثل .[Total_Price <= 200] عقد البيانات الشقيقة حسب قيمة ابنها العددي، وتبحث محددات السلالة مثل $data..Total_Price أسفل نطاق datasets الحالي، وتبحث محددات الأبناء الشاملة مثل $data.Receipt.*.Total_Price أسفل كل فرع ابن مباشر

NewValue القيمة الجديدة لحقل XFA؛ عندما يتضمن XFAFieldName‏ [*] أو محدد أبناء شاملًا أو محدد مسند، تُكتب القيمة نفسها في كل عقدة بيانات مطابقة

XFAFieldName	اسم حقل datasets في XFA المطلوب التعامل معه؛ يقبل مسارات حقول نسبية وجذور SOM‏ `$data...` و`xfa.datasets.data...` و`!data...` و`$record...`، بفواصل نقطية أو مائلة قبل الجذر أو بعده؛ وتحافظ المسارات المحددة بالمائل على النقاط الحرفية، وتقبل مسارات SOM النقطية نقاطًا مُهرَّبة مثل `Line\.Item`، ويمكن اختيار عقد البيانات المتكررة بمسارات `[]` مثل `$data.Receipt.Detail[].Total_Price`، ويمكن لـ `parent` التسلق إلى أب العقدة المختارة قبل متابعة المسار، وتخاطب محددات الأصناف مثل `#dataGroup` و`#dataValue` مجموعات Data DOM والقيم العددية، وتصفّي محددات المسند البسيطة مثل `.[Total_Price <= 200]` عقد البيانات الشقيقة حسب قيمة ابنها العددي، وتبحث محددات السلالة مثل `$data..Total_Price` أسفل نطاق datasets الحالي، وتبحث محددات الأبناء الشاملة مثل `$data.Receipt.*.Total_Price` أسفل كل فرع ابن مباشر
NewValue	القيمة الجديدة لحقل XFA؛ عندما يتضمن `XFAFieldName`‏ `[*]` أو محدد أبناء شاملًا أو محدد مسند، تُكتب القيمة نفسها في كل عقدة بيانات مطابقة