عنصر ساختار
نمای کلی
StructureElement یک کلاس در Aspose.PDF FOSS برای .NET است. ارثبری از: Element، ITextElement.
کلاس پایه برای عناصر ساختار منطقی PDF برچسبدار.
این کلاس 12 متد برای کار با اشیاء StructureElement در برنامههای .NET فراهم میکند.
متدهای موجود شامل: AdjustPosition، AppendChild، ChangeParentElement، ClearId، Detach، FindElements، RemoveAndMoveItsChildObjectsToItsParent، SetId، SetTag، SetText، ToString.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET قابل دسترسی هستند.
ویژگیها: ActualText، AlternativeText، Attributes، ChildElements، ExpansionText، ID، و 6 مورد دیگر.
ویژگیها
| Name | Type | Access | Description |
|---|---|---|---|
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 را پیدا کنید. |
AppendChild(child: StructureElement, validate: bool) | فرزند را با یک عبور اعتبارسنجی اختیاری اضافه کنید. |
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() | این عنصر را از والد خود جدا کنید. |
