StructTreeRootElement
نمای کلی
StructTreeRootElement یک کلاس در Aspose.PDF FOSS برای .NET است.
ارثبری میکند از: StructureElement.
قاب /StructTreeRoot در بالای درخت ساختار منطقی.
این کلاس ۱۱ متد برای کار با اشیاء StructTreeRootElement در برنامههای .NET فراهم میکند.
متدهای موجود شامل: AdjustPosition، AppendChild، ChangeParentElement، ClearId، Detach، FindElements، RemoveAndMoveItsChildObjectsToItsParent، SetId، SetTag، SetText، ToString هستند.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET قابل دسترسی هستند.
ویژگیها: ActualText، AllElements، AlternativeText، Attributes، ChildElements، ExpansionText و ۷ مورد دیگر.
ویژگیها
| Name | Type | Access | Description |
|---|---|---|---|
AllElements | IReadOnlyList<StructureElement> | Read | فهرست صاف از تمام عناصر ساختاری زیر ریشه، که توسط یک پیمایش عمق‑اول از ChildElements تولید میشود. |
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 | فرزندان مستقیم این عنصر. |
متدها
| امضا | توضیح |
|---|---|
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) | تابع جایگزین بدون عملیات برای سازگاری با API نویسندگی AdjustPosition نگه داشته شده است — FOSS هنوز از طریق PositionSettings رندر نمیشود. |
ChangeParentElement(newParent: StructureElement, validate: bool) | این عنصر را زیر newParent منتقل کنید. |
RemoveAndMoveItsChildObjectsToItsParent(validate: bool) | این عنصر را جدا کنید، سپس فرزندان آن را زیر والد قبلی این عنصر (با گرفتن جای این عنصر) بازپدر کنید. |
Detach() | این عنصر را از والد خود جدا کنید. |
