TextMarkupAnnotation
نظرة عامة
TextMarkupAnnotation هي فئة في Aspose.PDF FOSS لـ .NET. ترث من: MarkupAnnotation.
الفئة الأساسية لتعليقات النص-العلامية (Highlight, Underline, StrikeOut, Squiggly) — تلك التي تكون هندستها مجموعة من QuadPoints فوق نص الصفحة.
توفر هذه الفئة 17 طريقة للعمل مع كائنات TextMarkupAnnotation في برامج .NET. تشمل الطرق المتاحة: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetMarkedText, GetMarkedTextFragments, GetRectangle, GetState, GetStateModel, MarkupAnnotation، و5 طرق إضافية. جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS لـ .NET. الخصائص: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState، و44 أخرى.
خصائص
| اسم | النوع | الوصول | وصف |
|---|---|---|---|
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 | قراءة/كتابة | محاذاة النص (لتعليقات free-text / widget التي تحمل نصًا غنيًا). |
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 (المُعدَّل) كـ DateTime مكتوب. |
Flags | AnnotationFlags | قراءة/كتابة | علامات التعليق (/F entry) — تُستخدم كدعم تخزين لكل من الصيغ int والمُعَرَّفة. |
AnnotationFlags | AnnotationFlags | قراءة/كتابة | اسم مستعار مكتوب من نوع Flags يطابق السطح العام Aspose.Pdf الذي يكشف عن AnnotationFlags كخاصية. |
Action | PdfAction? | قراءة/كتابة | الإجراء المرتبط بهذه التعليقة (/A entry). |
Actions | PdfActionCollection | قراءة | مجموعة من الإجراءات المرتبطة بهذه التعليقة. |
Author | string? | قراءة | مؤلف التعليقة (/T entry). |
AnnotationState | string? | قراءة | حالة التعليق (/State entry)، على سبيل المثال. |
AnnotationStateModel | string? | قراءة | نموذج حالة التعليق (/StateModel entry)، على سبيل المثال. |
InReplyTo | Annotation? | قراءة/كتابة | التعليق الذي يرد عليه هذا التعليق (/IRT entry). |
QuadPoints | Point[] | قراءة/كتابة | QuadPoints كمصفوفة من قيم Point. |
Characteristics | Characteristics | قراءة | خصائص المظهر (لون الحدود، لون الخلفية، الدوران). |
PageIndex | int | قراءة | فهرس الصفحة يبدأ من 1 للصفحة التي تملك هذا التعليق. |
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) | الدالة ctor المرتبطة بالمستند (تُضاف إلى صفحة لاحقًا). |
GetMarkedText() | النص المغطى بـ QuadPoints لهذه التعليقة، مع نص كل رباعية (كل سطر مميز) مفصول بـ NewLine. |
GetMarkedTextFragments() | مقاطع نص الصفحة المغطاة بـ QuadPoints لهذه التعليقة — مقطع مقصوص واحد لكل مقطع مصدر يتقاطع معه كل رباعية. |
MarkupAnnotation(document: Document) | منشئ مرتبط بالمستند لإنشاء تعليقة تنسيق لم تُربط بعد بصفحة محددة؛ يضيفها المستدعون لاحقًا عبر page.Annotations.Add(annot). |
GetState() | اقرأ الإدخال /State في قاموس خصائص التعليقة. |
GetStateModel() | اقرأ إدخال /StateModel، مع تعيين الإدخال المفقود /entry إلى Undefined. |
SetMarkedState(marked: bool) | اضبط /State إلى Marked أو Unmarked بالإضافة إلى /StateModel = Marked. |
SetReviewState(state: AnnotationState) | تعيين حالة المراجعة. |
ClearState() | أزل أي /State مسجل و /StateModel. |
FindStateAnnotation() | ابحث عن التعليق التوضيحي لتتبع الحالة المرتبط بهذا الترميز (أحدث تعليق رد /IRT يحمل إدخال /State، وفقًا لـ PDF 32000 §12.5.6.3). |
Accept(visitor: AnnotationSelector) | أرسل هذه التعليقة إلى التحميل الزائد (overload) للوظيفة Visit(SubType) المكتوبة بنوع للزائر. |
GetRectangle(considerRotation: bool) | تم تعديل المستطيل الحدودي بواسطة considerRotation. |
ChangeAfterResize(transform: Matrix) | ضبط هندسة التعليق بعد أن قام المستخدم بتغيير حجم الصفحة أو المستطيل المضيف. |
UpdateAppearances() | إعادة إنشاء تدفق المظهر العادي (/AP /N) من هندسة التعليق الحالية والألوان. |
WriteXfdf(writer: System.Xml.XmlWriter) | تحويل هذا التعليق إلى عنصر XFDF للكاتب (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | قم بتسطيح هذه التعليقة — عرض مظهرها البصري ضمن محتوى الصفحة وإزالتها من مصفوفة التعليقات التوضيحية للصفحة. |
Clone() | استنساخ سطحي — ينسخ الحالة scalar/ref-shared. |
