ScreenAnnotation
نمای کلی
ScreenAnnotation یک کلاس در Aspose.PDF FOSS برای .NET است.
ارثبری میکند از: Annotation.
کلاس ScreenAnnotation به شما امکان میدهد یک حاشیهنویسی صفحهای را به یک صفحه اضافه کنید با ارائه صفحه، مستطیل و فایل رسانهای، و ویژگیهای AnnotationType، Action و Title را در دسترس قرار میدهد.
این کلاس 8 متد برای کار با اشیاء ScreenAnnotation در برنامههای .NET فراهم میکند.
متدهای موجود شامل: Accept، ChangeAfterResize، Clone، Flatten، GetRectangle، ScreenAnnotation، UpdateAppearances، WriteXfdf هستند.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET قابل دسترسی هستند.
خواص: Action، Actions، ActiveState، Alignment، AnnotationFlags، AnnotationState و 40 مورد دیگر.
ویژگیها
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
AnnotationType | AnnotationType | Read | همیشه صفحه. |
Action | PdfAction? | Read | عملیات رندر‑راهاندازی (/A entry)، یا null وقتی تنظیم نشده باشد. |
Title | string? | Read/Write | عنوان/برچسب نمایش داده شده در نوار مرورگر (/T entry). |
Rect | Rectangle? | Read/Write | مستطیل حاشیهنویسی (موقعیت در صفحه). |
Width | double | Read/Write | عرض مستطیل حاشیهنویسی. |
Height | double | Read/Write | ارتفاع مستطیل حاشیهنویسی. |
ActiveState | string? | Read/Write | وضعیت ظاهر فعلی فعال (/AS entry). |
Alignment | TextAlignment | Read/Write | تراز متن (برای حاشیهنویسیهای متن آزاد / ویجت که متن غنی دارند). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | تراز افقی، علاوه بر Alignment در دسترس است؛ هر دو بهصورت مستقل قابل تنظیم هستند. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | لغو تراز افقی خاص متن. |
Appearance | AppearanceDictionary | Read | دایرکتوری ظاهر (/AP entry) — کلید شده با نام جریان ظاهر (N, D, R). |
States | AppearanceDictionary | Read | دایرکتوری وضعیت ظاهر (زیر‑دایرکتوری هر وضعیت از AP/N، به عنوان مثال |
NormalAppearance | XForm? | Read | ظاهر عادی (/AP /N) حاشیهنویسی بهصورت XForm، یا null وقتی وجود نداشته باشد. |
UpdateAppearanceOnConvert | bool | Read/Write | اینکه آیا جریان ظاهر هنگام ذخیره حاشیهنویسی در سند تبدیلشده بازتولید شود یا نه. |
UseFontSubset | bool | Read/Write | اینکه آیا قلم جاسازیشده (در صورت وجود) باید زیرمجموعه شود یا نه. |
Contents | string? | Read/Write | محتویات حاشیهنویسی (متن). |
Opacity | double | Read/Write | شفافیت حاشیهنویسی (0.0 = شفاف، 1.0 = مات). |
Border | Border? | Read/Write | حاشیه حاشیهنویسی. |
Color | Color | Read/Write | رنگ حاشیه حاشیهنویسی (/C entry). |
InteriorColor | Color? | Read/Write | رنگ داخلی حاشیهنویسی (/IC entry، برای حاشیهنویسیهای دایره/مربع/خط). |
Name | string? | Read/Write | نام حاشیهنویسی (شناسه یکتا — ورودی /NM). |
FullName | string? | Read | نام کامل حاشیهنویسی. |
Subject | string? | Read/Write | موضوع حاشیهنویسی (/Subj entry). |
ModifiedDate | string? | Read | تاریخ اصلاح. |
Modified | DateTime | Read/Write | تاریخ /M (اصلاحشده) بهصورت DateTime تایپشده. |
Flags | AnnotationFlags | Read/Write | پرچمهای حاشیهنویسی (/F entry) — بهعنوان ذخیرهسازی برای هر دو فرم عددی و تایپشده استفاده میشود. |
AnnotationFlags | AnnotationFlags | Read/Write | نام مستعار تایپشده پرچمها که AnnotationFlags را بهعنوان یک ویژگی نشان میدهد. |
Actions | PdfActionCollection | Read | مجموعهای از عملیاتهای مرتبط با این حاشیهنویسی. |
Author | string? | Read | نویسنده حاشیهنویسی (/T entry). |
AnnotationState | string? | Read | وضعیت حاشیهنویسی (/State entry)، به عنوان مثال |
AnnotationStateModel | string? | Read | مدل وضعیت حاشیهنویسی (/StateModel entry)، به عنوان مثال |
ReplyType | string? | Read | نوع پاسخ (/RT entry)، به عنوان مثال |
InReplyTo | Annotation? | Read/Write | حاشیهنویسیای که این مورد به آن پاسخ میدهد (/IRT entry). |
QuadPoints | Point[] | Read/Write | QuadPoints بهصورت آرایهای از مقادیر Point. |
Characteristics | Characteristics | Read | ویژگیهای ظاهر (رنگ حاشیه، رنگ پسزمینه، چرخش). |
PageIndex | int | Read | اندیس 1‑پایه صفحهای که این حاشیهنویسی را دارد. |
Page | Page? | Read | صفحهای که این حاشیهنویسی را دارد، یا null وقتی قابل حل نیست (به عنوان مثال |
VerticalAlignment | VerticalAlignment | Read/Write | تراز عمودی اعمالشده به این پاراگراف. |
Margin | MarginInfo? | Read/Write | اطلاعات حاشیه بیرونی اعمالشده به این پاراگراف. |
IsFirstParagraphInColumn | bool | Read/Write | اجبار پاراگراف برای شروع ستون جدید. |
IsKeptWithNext | bool | Read/Write | نگه داشتن این پاراگراف در همان صفحه با پاراگراف بعدی. |
IsInNewPage | bool | Read/Write | اجبار پاراگراف برای شروع در صفحه جدید. |
IsInLineParagraph | bool | Read/Write | پرچم پاراگراف درونخطی (خط جدیدی شروع نمیکند). |
HyperlinkText | string? | Read/Write | هدف پیوندهای ابرمتنی بهصورت رشتهای قدیمی. |
Hyperlink | Hyperlink? | Read/Write | دکوراسیون پیوند ابرمتنی تایپشده اعمالشده به پاراگراف. |
ZIndex | int | Read/Write | اندیس Z‑order استفادهشده توسط رندرر DOM. |
روشها
| امضا | توضیح |
|---|---|
ScreenAnnotation(page: Page, rect: Rectangle, mediaFile: string) | یک حاشیهنویس صفحهای ایجاد میکند که به mediaFile ارجاع میدهد. |
Accept(visitor: AnnotationSelector) | متد Accept را بر روی این نمونه ScreenAnnotation فراخوانی میکند. |
GetRectangle(considerRotation: bool) | مستطیل محدودکننده با توجه به considerRotation تنظیم میشود. |
ChangeAfterResize(transform: Matrix) | پس از تغییر اندازه صفحه یا مستطیل میزبان توسط کاربر، هندسه حاشیهنویس تنظیم میشود. |
UpdateAppearances() | جریان ظاهر عادی (/AP /N) را از هندسه و رنگهای فعلی حاشیهنویس بازتولید میکند. |
WriteXfdf(writer: System.Xml.XmlWriter) | این حاشیهنویس را به عنوان یک عنصر XFDF به writer سریالسازی میکند (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | این حاشیهنویس را صاف میکند — ظاهر بصری آن را در محتوای صفحه رندر میکند و از آرایه حاشیهنویسهای صفحه حذف مینماید. |
Clone() | کلون سطحی — وضعیت اسکالر/مرجع‑بهاشتراکگذاریشده را کپی میکند. |
