OBJRElement
نظرة عامة
OBJRElement هي فئة في Aspose.PDF FOSS لـ .NET. تورث من: StructureElement.
مرجع كائن (الدور “OBJR”) — يربط عنصر بنية بكائن PDF على صفحة (عادةً تعليق، على سبيل المثال.
توفر هذه الفئة 11 طريقة للعمل مع كائنات OBJRElement في برامج .NET. تشمل الطرق المتاحة: AdjustPosition, AppendChild, ChangeParentElement, ClearId, Detach, FindElements, RemoveAndMoveItsChildObjectsToItsParent, SetId, SetTag, SetText, ToString. جميع الأعضاء العامة يمكن الوصول إليها من أي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS لـ .NET. الخصائص: ActualText, AlternativeText, Attributes, ChildElements, ExpansionText, ID, و 8 أخرى.
خصائص
| اسم | النوع | الوصول | وصف |
|---|---|---|---|
Obj | object? | قراءة | كائن PDF المشار إليه (المستخرج من /Obj)، أو null. |
StructureTextState | StructureTextState | قراءة | حالة النص المطبقة على المحتوى المضمن لهذا العنصر (محفوظة فقط — لا يعيد مُنشئ بنية FOSS العرض من خلالها). |
Attributes | StructureElementAttributes | قراءة | سمات البنية (/A) المرفقة بهذا العنصر، منظمة حسب المالك. |
StructureType | string | قراءة | دور نوع بنية PDF (/S entry، على سبيل المثال. |
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() | افصل هذا العنصر عن والده. |