MCRElement
نظرة عامة
MCRElement هي فئة في Aspose.PDF FOSS لـ .NET. ترث من: StructureElement.
ورقة مرجع محتوى معلم (الدور “MCR”) تُصدرها أداة الوسم التلقائي لتحديد مكان وجود محتوى صفحة عنصر البنية.
توفر هذه الفئة 11 طريقة للعمل مع كائنات MCRElement في برامج .NET. تشمل الطرق المتاحة: AdjustPosition, AppendChild, ChangeParentElement, ClearId, Detach, FindElements, RemoveAndMoveItsChildObjectsToItsParent, SetId, SetTag, SetText, ToString. جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS لـ .NET. الخصائص: ActualText, AlternativeText, Attributes, ChildElements, ExpansionText, ID، و7 أخرى.
خصائص
| اسم | النوع | الوصول | وصف |
|---|---|---|---|
StructureTextState | StructureTextState | قراءة | حالة النص المطبقة على المحتوى المضمن لهذا العنصر (مخزنة فقط — لا يعيد مُنشئ البنية المفتوح المصدر (FOSS) إعادة العرض عبرها). |
Attributes | StructureElementAttributes | قراءة | سمات البنية (/A) المرفقة بهذا العنصر، منظمة حسب المالك. |
StructureType | string | قراءة | دور نوع بنية PDF (إدخال /S، على سبيل المثال. |
S | StructureType | قراءة | نوع بنية العنصر (/S) كـ StructureType التي يكون اسمها وسم الدور (على سبيل المثال. |
ActualText | string | قراءة/كتابة | النص البديل للمحتوى المعلَّم (/ActualText). |
AlternativeText | string | قراءة/كتابة | نص بديل يُستخدم بواسطة تكنولوجيا المساعدة (/Alt). |
ExpansionText | string | قراءة/كتابة | نص التوسيع للاختصار (/E). |
Language | string | قراءة/كتابة | BCP-47 رمز اللغة لمحتوى العنصر (/Lang). |
ID | string | قراءة | معرّف العنصر (/ID); للقراءة فقط — يُعيَّن عند الحفظ. |
Title | string | قراءة/كتابة | عنوان عنصر البنية (/T). |
Page | Page? | قراءة | الصفحة التي تستضيف محتوى هذا العنصر، أو null عندما لم يتم إرفاق العنصر بصفحة بعد. |
ParentElement | StructureElement? | قراءة | عنصر بنية الأب، أو null عندما يكون هذا العنصر منفصلاً أو مباشرة تحت جذر شجرة البنية. |
ChildElements | ElementList | قراءة | الأبناء المباشرون لهذا العنصر. |
الطرق
| التوقيع | وصف |
|---|---|
AppendChild(child: StructureElement) | إلحاق عنصر فرعي تحت مصفوفة /K لهذا العنصر. |
SetTag(tag: string) | إعادة تعيين دور هذا العنصر إلى علامة مخصصة، مع تسجيل العلامة → نوعها القياسي في خريطة أدوار المستند. |
ToString() | التمثيل النصي المستخدم عند تفريغ شجرة البنية (اسم الدور؛ يُرجع إلى اسم النوع إذا لم يتوفر). |
FindElements(recursive: bool) | البحث بصورة متكررة عن العناصر المتفرعة من النوع T. |
SetText(text: string) | عيّن محتوى النص للعنصر (المخزن كـ ActualText). |
SetId(id: string) | تعيين معرف العنصر (/ID). |
ClearId() | إزالة معرف العنصر (/ID). |
AdjustPosition(settings: object) | التقاط موضع التخطيط المطلوب لعنصر بنية مؤلف. |
ChangeParentElement(newParent: StructureElement, validate: bool) | نقل هذا العنصر تحت newParent. |
RemoveAndMoveItsChildObjectsToItsParent(validate: bool) | افصل هذا العنصر، ثم أعد توطين أطفاله تحت الوالد السابق لهذا العنصر (مع أخذ موضع هذا العنصر). |
Detach() | افصل هذا العنصر عن والده. |
