المحولات

API الداخلية الطبقات الموجودة على هذه الصفحة ليست جزءا من واجهة برمجة التطبيق العامة ولا يتم تصديرها من المستوى العلوي aspose.words_foss يتم استخدامها داخلياً من قبل خط أنابيب التصدير. يجب على معظم المطورين استخدام Document.save() بدلاً من ذلك. انظر الإدارة الأساسية لـ API العامة.

Aspose.Words FOSS for Python uses specialized converter classes to transform the internal document model into output formats. ParagraphConverter يتعامل مع النصوص والتصميم،, TableConverter يُحمل بناءات الطاولة، و ListHandler يدير تشكيل القائمة. هذه الطبقات هي تفاصيل التنفيذ وقد تتغير دون إشعار.

محول الفقرة

ParagraphConverter يحول فقرات المستند إلى تنسيق الناتج الهدف. يفتش تكوين الفقرة، وتصميم مستوى التشغيل، ومحتوى الخط داخل الصفحة.

طريقة	وصف
`ParagraphConverter.get_paragraph_info()`	استخراج معلومات التنسيق من فقرة
`ParagraphConverter.get_run_formatting()`	احصل على تفاصيل التنسيق لتشغيل النص
`ParagraphConverter.format_text()`	تطبيق التنسيق على محتوى النص

محول الجدول

TableConverter تحويل جداول المستندات إلى الشكل المستهدف (مثل جداولا التخفيض).

طريقة	وصف
`TableConverter.convert()`	تحويل عنصر الجدول إلى تنسيق الناتج

مُعامل القائمة

ListHandler يدير حالة القائمة أثناء تحويل المستندات، وتعليق قائمة التتبع، والعرّجات، والتنسيق.

طريقة	وصف
`ListHandler.set_reader()`	تعيين قراءة الوثيقة لسياق القائمة
`ListHandler.reset()`	حالة تتبع القائمة لإعادة التثبيت
`ListHandler.get_list_info()`	الحصول على تفاصيل عنصر القائمة للفقرة
`ListHandler.format_list_item()`	صياغة عنصر القائمة مع علامة وندبة
`ListHandler.break_list()`	نهاية الإشارة لسلسلة القائمة

نصائح وأفضل الممارسات

المتحولات تستخدم داخلياً من قبل خط أنابيب التصدير معظم مطوري التطوير يتفاعلون مع Document.save() بدلاً من ذلك
ParagraphConverter.format_text() يحترم سياق الكتلة من الرمز لتجنب تطبيق التنسيق داخل الخط في نطاقات الشفرة.
ListHandler يحتفظ بالحالة عبر الفقرات المتتالية في القائمة المكالمة reset() عند بدء قسم جديد من المستندات

القضايا الشائعة

القضية	السبب	إصلاح
أعمدة الجدول غير المرتبطة	جدول الإدخال قد دمج الخلايا	`TableConverter` يتعامل مع الجداول البسيطة؛ قد تنتج الخلايا المدمجة نتائج غير متوقعة.
الترقيم المفصل للقوائم	حالة القائمة غير مُعاد ضبطها بين الأقسام	اتصلوا `ListHandler.reset()` في حدود القطاع

ملخص مرجع API

الفئة / الطريقة	وصف
`ParagraphConverter.get_paragraph_info()`	صياغة المقاطع الفقرية
`ParagraphConverter.get_run_formatting()`	الحصول على تنسيق مستوى التشغيل
`ParagraphConverter.format_text()`	تطبيق التنسيق على النص
`TableConverter.convert()`	تحويل الجدول إلى تنسيق الناتج
`ListHandler.set_reader()`	تعيين سياق قارئ المستندات
`ListHandler.get_list_info()`	الحصول على تفاصيل عنصر القائمة
`ListHandler.format_list_item()`	صياغة عنصر القائمة