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