TextMarkupAnnotation
نمای کلی
TextMarkupAnnotation یک کلاس در Aspose.PDF FOSS برای .NET است. ارث‌بری از: MarkupAnnotation.
کلاس پایه برای حاشیه‌گذاری‌های متن‌نشانه‌گذاری (Highlight, Underline, StrikeOut, Squiggly) — آنهایی که هندسه‌شان مجموعه‌ای از QuadPoints بر روی متن صفحه است.
این کلاس ۱۷ متد برای کار با اشیاء TextMarkupAnnotation در برنامه‌های .NET ارائه می‌دهد. متدهای موجود شامل: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetMarkedText, GetMarkedTextFragments, GetRectangle, GetState, GetStateModel, MarkupAnnotation و ۵ متد اضافی می‌باشند. تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS برای .NET برای هر برنامهٔ .NET قابل دسترسی هستند. ویژگی‌ها: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState و ۴۴ مورد دیگر.
خواص
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
CreationDate | System.DateTime | خواندن/نوشتن | زمان ایجاد در /CreationDate ثبت شد. |
Opacity | double | خواندن/نوشتن | شفافیت (0..1) در /CA حمل می‌شود. |
Popup | PopupAnnotation? | خواندن/نوشتن | حاشیه‌نویس پاپ-اپ مرتبط (/Popup). |
ReplyType | ReplyType | خواندن/نوشتن | ارتباط پاسخ به InReplyTo (/RT). |
RichText | string? | خواندن/نوشتن | محتوای متنی غنی (/RC)، قالب‌بندی شده به صورت XHTML. |
Subject | string? | خواندن/نوشتن | خط موضوع (/Subj). |
Title | string? | خواندن/نوشتن | نویسنده / عنوان در /T حمل می‌شود. |
AnnotationType | AnnotationType | خواندن | زیرنوع حاشیه‌نویسی. |
Rect | Rectangle? | خواندن/نوشتن | مستطیل حاشیه‌نویسی (موقعیت در صفحه). |
InnerRect | Rectangle? | خواندن | مستطیل حاشیه‌گذاری که توسط ورودی /RD (تفاوت‌های مستطیل) داخل آن قرار می‌گیرد — ناحیه‌ای که واقعاً داخل Rect رسم می‌شود. |
Width | double | خواندن/نوشتن | عرض مستطیل حاشیه‌گذاری. |
Height | double | خواندن/نوشتن | ارتفاع مستطیل حاشیه‌نویسی. |
ActiveState | string? | خواندن/نوشتن | وضعیت ظاهر فعلی فعال (/AS entry). |
Alignment | TextAlignment | خواندن/نوشتن | تراز متن (برای یادداشت‌های متن آزاد / ویجت که متن غنی دارند). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | خواندن/نوشتن | تراز افقی (Aspose.Pdf این را علاوه بر Alignment نمایش می‌دهد؛ هر دو به‌صورت مستقل قابل تنظیم هستند). |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | خواندن/نوشتن | بازنویسی تراز افقی مخصوص متن. |
Appearance | AppearanceDictionary | خواندن | دایرکتوری ظاهر (/AP entry) — کلید شده با نام جریان ظاهر (N, D, R). |
States | AppearanceDictionary | خواندن | دایرکتوری حالت-ظاهر (زیر-دایرکتوری مربوط به هر حالت از AP/N، به عنوان مثال. |
NormalAppearance | XForm? | خواندن | ظاهر عادی (/AP /N) حاشیه‌نویسی به صورت XForm، یا null وقتی که هیچ‌یک وجود نداشته باشد. |
UpdateAppearanceOnConvert | bool | خواندن/نوشتن | آیا هنگام ذخیرهٔ حاشیه‌نویسی در سند تبدیل‌شده، جریان ظاهر دوباره تولید شود. |
UseFontSubset | bool | خواندن/نوشتن | آیا فونت جاسازی‌شده (در صورت وجود) باید زیرمجموعه‌سازی شود. |
Contents | string? | خواندن/نوشتن | محتوای حاشیه‌نویسی (متن). |
Border | Border? | خواندن/نوشتن | حاشیهٔ حاشیه‌نویسی. |
Color | Color | خواندن/نوشتن | رنگ حاشیهٔ حاشیه‌نویسی (/C entry). |
InteriorColor | Color? | خواندن/نوشتن | رنگ داخلی حاشیه‌نویسی (/IC entry، برای حاشیه‌نویسی‌های دایره/مربع/خط). |
Name | string? | خواندن/نوشتن | نام حاشیه‌نویسی (شناسهٔ یکتا — ورودی /NM). |
FullName | string? | خواندن | نام حاشیه‌نویسی به‌صورت کامل. |
ModifiedDate | string? | خواندن | تاریخ تغییر. |
Modified | DateTime | خواندن/نوشتن | تاریخ /M (modified) به‌صورت DateTime تایپ‌شده. |
Flags | AnnotationFlags | خواندن/نوشتن | پرچم‌های حاشیه‌نویسی (/F entry) — به عنوان پشتوانه ذخیره‌سازی برای هر دو فرم عددی و تایپی استفاده می‌شوند. |
AnnotationFlags | AnnotationFlags | خواندن/نوشتن | نام مستعار تایپی Flags که با سطح عمومی Aspose.Pdf مطابقت دارد و AnnotationFlags را به‌عنوان یک ویژگی نمایش می‌دهد. |
Action | PdfAction? | خواندن/نوشتن | عمل مرتبط با این حاشیه‌نویسی (/A entry). |
Actions | PdfActionCollection | خواندن | مجموعه‌ای از اعمال مرتبط با این حاشیه‌نویسی. |
Author | string? | خواندن | نویسندهٔ حاشیه (/T entry). |
AnnotationState | string? | خواندن | وضعیت حاشیه (/State entry)، مثلاً. |
AnnotationStateModel | string? | خواندن | مدل وضعیت حاشیه‌نویسی (ورودی /StateModel)، به عنوان مثال، |
InReplyTo | Annotation? | خواندن/نوشتن | حاشیه‌نویسی‌ای که این مورد به آن پاسخ می‌دهد (ورودی /IRT). |
QuadPoints | Point[] | خواندن/نوشتن | QuadPoints به عنوان آرایه‌ای از مقادیر Point. |
Characteristics | Characteristics | خواندن | ویژگی‌های ظاهر (رنگ حاشیه، رنگ پس‌زمینه، چرخش). |
PageIndex | int | خواندن | اندیس یک‌پایه صفحه‌ای که این حاشیه‌نویسی را مالک است. |
Page | Page? | خواندن | صفحه‌ای که این حاشیه‌نویسی را دارد، یا null وقتی که قابل حل نیست (مثلاً. |
VerticalAlignment | VerticalAlignment | خواندن/نوشتن | تراز عمودی اعمال‌شده به این پاراگراف. |
Margin | MarginInfo | خواندن/نوشتن | اطلاعات حاشیه بیرونی به این پاراگراف اعمال شد. |
IsFirstParagraphInColumn | bool | خواندن/نوشتن | پاراگراف را مجبور کنید تا در یک ستون جدید شروع شود. |
IsKeptWithNext | bool | خواندن/نوشتن | این پاراگراف را در همان صفحه‌ای که پاراگراف بعدی قرار دارد نگه دارید. |
IsInNewPage | bool | خواندن/نوشتن | پاراگراف را مجبور کنید تا در صفحه جدیدی شروع شود. |
IsInLineParagraph | bool | خواندن/نوشتن | پرچم پاراگراف درون‌خطی (خط جدیدی را شروع نمی‌کند). |
HyperlinkText | string? | خواندن/نوشتن | هدف پیوند ابرمتنی به‌صورت رشته‌ای کهنه. |
Hyperlink | Hyperlink? | خواندن/نوشتن | دکوراسیون پیوند ابرمتنی نوعی که بر پاراگراف اعمال می‌شود. |
ZIndex | int | خواندن/نوشتن | شاخص Z-order که توسط رندرر DOM استفاده می‌شود. |
روش ها
| امضا | توضیح |
|---|---|
TextMarkupAnnotation(document: Document) | سازندهٔ مرتبط با سند (بعداً به صفحه اضافه می‌شود). |
GetMarkedText() | متنی که توسط QuadPoints این حاشیه‌نویسی پوشش داده می‌شود، به‌طوری‌که متن هر چهارگوش (هر خط برجسته) با NewLine جدا شده است. |
GetMarkedTextFragments() | تکه‌های متن صفحه‌ای که توسط QuadPoints این حاشیه‌نویسی پوشش داده می‌شوند — یک تکه برش خورده برای هر تکه منبع که هر چهارگوشه با آن همپوشانی دارد. |
MarkupAnnotation(document: Document) | سازنده‌ای (ctor) وابسته به سند برای ایجاد یک حاشیه‌نویسی نشانه‌گذاری که هنوز به صفحه خاصی پیوست نشده است؛ فراخوانندگان آن را بعداً از طریق page.Annotations.Add(annot) اضافه می‌کنند. |
GetState() | ورودی /State را در دیکشنری ویژگی‌های حاشیه‌نویس بخوانید. |
GetStateModel() | ورودی /StateModel را بخوانید و ورودی گمشده /entry را به Undefined نگاشت کنید. |
SetMarkedState(marked: bool) | Set /State to Marked or Unmarked plus /StateModel = Marked. |
SetReviewState(state: AnnotationState) | وضعیت بررسی را تنظیم کنید. |
ClearState() | هر /State و /StateModel ثبت‌شده را حذف کنید. |
FindStateAnnotation() | حاشیه‌نویسی ردیابی وضعیت مرتبط با این علامت‌گذاری را پیدا کنید (آخرین حاشیه‌نویسی پاسخ /IRT که یک ورودی /State دارد، طبق PDF 32000 §12.5.6.3). |
Accept(visitor: AnnotationSelector) | این حاشیه‌نویسی را به overload تایپ‌شده Visit(SubType) از visitor ارسال کنید. |
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() | این annotation را مسطح کنید — ظاهر بصری آن را در محتوای صفحه رندر کنید و آن را از آرایهٔ annotations صفحه حذف کنید. |
Clone() | Shallow clone — وضعیت scalar/ref-shared را کپی می‌کند. |
