IllustrationElement
نظرة عامة
IllustrationElement هي فئة في Aspose.PDF FOSS لـ .NET.
ترث من: StructureElement.
قاعدة تجريدية لعناصر بنية من نوع التوضيح (Figure, Formula).
توفر هذه الفئة 14 طريقة للعمل مع كائنات IllustrationElement في برامج .NET.
تشمل الطرق المتاحة: AdjustPosition، AppendChild، ChangeParentElement، ClearId، Detach، FindElements، RemoveAndMoveItsChildObjectsToItsParent، SetId، SetImage، SetTag، SetText، ToString.
جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS for .NET.
الخصائص: ActualText، AlternativeText، Attributes، ChildElements، ExpansionText، ID، و10 أخرى.
الخصائص
| الاسم | النوع | الوصول | الوصف |
|---|---|---|---|
ImagePath | string? | Read | ملف الصورة الداعم لهذه الرسمة. |
ImageWidth | double | Read | تجاوز عرض الصورة (0 = تلقائي). |
ImageHeight | double | Read | تجاوز ارتفاع الصورة (0 = تلقائي). |
Resolution | int | Read | تجاوز دقة الصورة (DPI) (0 = تلقائي). |
StructureTextState | StructureTextState | Read | حالة النص المطبقة على المحتوى المضمن لهذا العنصر (مخزنة فقط — لا يعيد مُنشئ البنية إعادة العرض من خلالها). |
Attributes | StructureElementAttributes | Read | سمات البنية (/A) المرتبطة بهذا العنصر، منظمة حسب المالك. |
StructureType | string | Read | دور نوع بنية PDF (/S entry، على سبيل المثال |
ActualText | string | Read/Write | نص الاستبدال للمحتوى المميز (/ActualText). |
AlternativeText | string | Read/Write | النص البديل المستخدم من قبل تقنيات المساعدة (/Alt). |
ExpansionText | string | Read/Write | نص التوسيع للاختصار (/E). |
Language | string | Read/Write | رمز اللغة BCP-47 لمحتوى العنصر (/Lang). |
ID | string | Read | معرف العنصر (/ID)؛ للقراءة فقط — يُعيّن عند الحفظ. |
Title | string | Read/Write | عنوان عنصر البنية (/T). |
Page | Page? | Read | الصفحة التي تستضيف محتوى هذا العنصر، أو null عندما لم يُرفق العنصر بصفحة بعد. |
ParentElement | StructureElement? | Read | عنصر البنية الأب، أو null عندما يكون هذا العنصر منفصلًا أو تحت جذر شجرة البنية مباشرة. |
ChildElements | ElementList | Read | الأبناء المباشرين لهذا العنصر. |
الطرق
| Signature | Description |
|---|---|
SetImage(imagePath: string) | ربط صورة نقطية/متجهة بهذه الرسمة. |
SetImage(imagePath: string, width: double, height: double) | ربط صورة بأبعاد صريحة. |
SetImage(imagePath: string, resolution: int) | ربط صورة بدقة صريحة (DPI). |
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) | Stub no-op يُحافظ على التوافق مع AdjustPosition authoring API — FOSS لا يعرض عبر PositionSettings بعد. |
ChangeParentElement(newParent: StructureElement, validate: bool) | نقل هذا العنصر تحت newParent. |
RemoveAndMoveItsChildObjectsToItsParent(validate: bool) | فصل هذا العنصر، ثم إعادة توطين أطفاله تحت الوالد السابق لهذا العنصر (مع أخذ موقع هذا العنصر). |
Detach() | فصل هذا العنصر عن والده. |
