المفحصين
المفحصين
API الداخلية الطبقات الموجودة على هذه الصفحة ليست جزءا من واجهة برمجة التطبيق العامة ولا يتم تصديرها من المستوى العلوي
aspose.words_fossيتم استخدامها داخلياً من خلال خط التحول المستند. يجب على معظم المطورين استخدامDocument.save()وDocument.get_text()بدلاً من ذلك. انظر الإدارة الأساسية هذه الفئات هي تفاصيل التنفيذ ويمكن أن تتغير دون إشعار.
Aspose.Words FOSS for Python includes specialized parsers that extract structured data from DOCX internals. The NumberingParser يتعامل مع تعريفات الترقيم في القوائم، و StyleParser يستخرج أنماط المستندات.
تحليل الرقم
NumberingParser يقرأ تعريفات الترقيم من حزمة DOCX ويعرضها عبر API الاستعلام. استخدم parse_numbering_part() لتحميل إكس إل الترقيم، ثم استفسار صفات القائمة مع أساليب مساعدة.
| طريقة | وصف |
|---|---|
NumberingParser.parse_numbering_part() | تحليل عنصر ترقيم DOCX |
NumberingParser.get_list_info() | احصل على معلومات عن قائمة محددة حسب الهوية |
NumberingParser.get_level_info() | احصل على تفاصيل مستوى لقائمة في عمق معين |
NumberingParser.is_ordered_list() | تحقق من ترتيب مستوى القائمة أو وضعها في صفحة الرؤوس. |
NumberingParser.get_start_value() | احصل على رقم البداية لمستوى القائمة |
NumberingParser.get_delimiter() | احصل على سلسلة الحدود لمستوى القائمة |
نمط تحليل
StyleParser تحليل أسماء الأسلوب إلى منظمات ParsedStyle يحدد العناوين، والبلوكوتات، وكتل الرمز، وقواعد القائمة من أسماء أسلوب DOCX.
| طريقة | وصف |
|---|---|
StyleParser.parse() | تحليل اسم النمط إلى a ParsedStyle المادة |
StyleParser.get_style_chain() | تحليل سلسلة من أسماء الأساليب للأسالib الموروثة |
StyleParser.is_setext_heading() | تحقق من أن النمط هو عنوان بنموذج Setext |
StyleParser.extract_all_styles() | استخراج أسماء الأسلوب الفردية من سلسلة منفصلة عن طريق العقدة |
نموذج بيانات الترقيم
يتم تخزين بيانات الترقيم المتحلل في كائنات منظمة:
| الفئة | وصف |
|---|---|
NumberingInfo | تعريف الترقيم مع: num_id, abstract_num_id,، و levels |
NumberingLevel | تعريف المستوى مع: format, start,، و text الممتلكات |
ListInfo | معلومات عن مثال قائمة محددة |
ListLevelInfo | تفاصيل التنسيق الخاصة بالمستوى |
نصائح وأفضل الممارسات
- اتصلوا
parse_numbering_part()مرة واحدة بعد تحميل المستند لملء جميع تعريفات القائمة - استخدام
is_ordered_list()لتمييز القوائم المرقمة عن القائمات المتصوّرة. - استخدام
get_style_chain()تحليل سلسلة الأسلوب الموروثة في مكالمة واحدة - يتم استخدام أجهزة تحليل الأرقام والأسلوب داخلياً من خلال خط التحول المستندي.
القضايا الشائعة
| القضية | السبب | إصلاح |
|---|---|---|
| تعريفات الترقيم الفارغة | المستند لا يحتوي على قوائم | التحقق get_list_info() قيمة العودة قبل الوصول إلى الممتلكات |
| النمط المفقود | اسم النمط غير معترف به | استخدام parse() مع اسم نمط معروف |
| مستوى قائمة غير صحيح | معدل مستوى خاطئ | مستويات القائمة هي صفر المؤشرات. |
ملخص مرجع API
| الفئة / الطريقة | وصف |
|---|---|
NumberingParser.parse_numbering_part() | تعريفات ترقيم DOCX Parse |
NumberingParser.get_list_info() | معلومات قائمة الاستعلامات حسب الهوية |
NumberingParser.is_ordered_list() | تحقق من ترتيب مستوى القائمة |
StyleParser.parse() | تحليل اسم النمط في معلومات منظمة |
StyleParser.get_style_chain() | تحليل سلسلة من أسماء الأساليب الموروثة |
NumberingInfo | نموذج بيانات تعريف الترقيم |
NumberingLevel | تعريف المستوى مع الشكل والقيمة الأولية |
