GetXFAFormFieldValueA

حقول النماذج

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ GetXFAFormFieldValue وتُفسر وسائط السلاسل بصفحة شيفرة 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[1].parent.Tax. وتحل محددات السلالة مثل $data..Total_Price أول عقدة بيانات مطابقة أسفل نطاق datasets الحالي. وتُرجع محددات الأبناء الشاملة مثل $data.Receipt.*.Total_Price عقد البيانات المطابقة أسفل كل فرع ابن مباشر

الصيغة

Delphi

Function DLGetXFAFormFieldValueA(InstanceID: Integer; XFAFieldName: PAnsiChar): PAnsiChar;

DLL

const char * DLGetXFAFormFieldValueA(int InstanceID, const char * 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 أسفل كل فرع ابن مباشر

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` أسفل كل فرع ابن مباشر