گروه محتوا اختیاری
نمای کلی
OptionalContentGroup یک کلاس در Aspose.PDF FOSS برای .NET است.
نمایانگر یک گروه محتوا اختیاری (لایه) در سند PDF.
این کلاس 9 متد برای کار با اشیاء OptionalContentGroup در برنامههای .NET فراهم میکند.
متدهای موجود شامل: AddContent، Delete، Flatten، Lock، OptionalContentGroup، Save، Unlock.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET قابل دسترسی هستند.
خواص: Contents، DefaultState، Id، Intent، IsLocked، IsVisible، و ۲ مورد دیگر.
ویژگیها
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
Name | string | خواندن | نام لایه. |
Id | string? | خواندن | شناسه OCG که در Resources/Properties صفحه استفاده میشود (مثلاً |
IsVisible | bool | خواندن/نوشتن | آیا این لایه در حال حاضر قابل مشاهده است یا خیر. |
IsLocked | bool | خواندن/نوشتن | آیا این لایه قفل شده است (قابل تغییر توسط کاربران نیست) یا خیر. |
Locked | bool | خواندن/نوشتن | نام مستعار برای IsLocked. |
DefaultState | DefaultState | خواندن/نوشتن | وضعیت پیشفرض قابل مشاهده بودن این لایه. |
Intent | string? | خواندن | هدف این لایه (مثلاً “View”، “Design”). |
Contents | IReadOnlyList<byte[]> | خواندن | عملگرهای محتوا (به صورت بایتهای خام) متعلق به این لایه را از جریان محتوا صفحه (علامتگذاریهای BDC/EMC) یا از جریانهای XForm که OCG این لایه را ارجاع میدهند، دریافت میکند. |
متدها
| Signature | Description |
|---|---|
OptionalContentGroup(id: string, name: string) | یک لایه جدید با شناسه و نام دادهشده ایجاد کنید. |
Lock() | این لایه را قفل کنید تا کاربران نتوانند آن را فعال/غیرفعال کنند. |
Unlock() | قفل این لایه را باز کنید. |
Flatten(cleanupContentStream: bool) | این لایه را صاف کنید — نشانگرهای BDC/EMC را حذف کنید اما محتوا را نگه دارید. |
Delete() | این لایه و تمام محتوای آن را از صفحه حذف کنید. |
Save() | محتوای این لایه را در یک سند PDF تکصفحه جدید ذخیره کنید. |
Save(stream: Stream) | محتوای این لایه را بهصورت یک PDF تکصفحه جدید در یک جریان ذخیره کنید. |
Save(outputPath: string) | محتوای این لایه را بهعنوان یک PDF تکصفحه جدید در یک فایل ذخیره کنید. |
AddContent(op: Operators.Operator) | یک عملگر محتوا به این لایه اضافه کنید (برای لایههای تازه ایجاد شده). |
