SetXFAFormFieldValueA

حقول النماذج

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ SetXFAFormFieldValue وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية

يضبط قيمة حقل نموذج 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 DLSetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName, NewValue: PAnsiChar): Integer;

DLL

int DLSetXFAFormFieldValueA(int InstanceID, const char * XFAFieldName, const char * 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`‏ `[*]` أو محدد أبناء شاملًا أو محدد مسند، تُكتب القيمة نفسها في كل عقدة بيانات مطابقة