MarkupAnnotation

نظرة عامة

MarkupAnnotation هي فئة في Aspose.PDF FOSS لـ .NET. ترث من: Annotation.

هذه الفئة توفر 15 طريقة للعمل مع كائنات MarkupAnnotation في برامج .NET. الطرق المتاحة تشمل: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetRectangle, GetState, GetStateModel, MarkupAnnotation, SetMarkedState, SetReviewState, وطرق إضافية 2. جميع الأعضاء العامين يمكن الوصول إليهم من أي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS for .NET. الخصائص: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState, و43 أخرى.

الخصائص

الاسم	النوع	الوصول	الوصف
`CreationDate`	`System.DateTime`	Read/Write	طابع زمني لإنشاء تم تسجيله في /CreationDate.
`Opacity`	`double`	Read/Write	العتامة (0..1) محمولة في /CA.
`Popup`	`PopupAnnotation?`	Read/Write	التعليق المنبثق المرتبط (/Popup).
`ReplyType`	`ReplyType`	Read/Write	علاقة الرد إلى InReplyTo (/RT).
`RichText`	`string?`	Read/Write	محتويات نص غني (/RC)، بتنسيق XHTML.
`Subject`	`string?`	Read/Write	سطر الموضوع (/Subj).
`Title`	`string?`	Read/Write	المؤلف / العنوان محمول في /T.
`AnnotationType`	`AnnotationType`	Read	نوع فرعي للتعليق.
`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	محتويات التعليق (نص).
`Border`	`Border?`	Read/Write	حدود التعليق.
`Color`	`Color`	Read/Write	لون حدود التعليق (/C entry).
`InteriorColor`	`Color?`	Read/Write	لون داخل التعليق (/IC entry، للتعليقات الدائرية/المربعة/الخطية).
`Name`	`string?`	Read/Write	اسم التعليق (معرف فريد — /NM entry).
`FullName`	`string?`	Read	اسم التعليق المؤهل بالكامل.
`ModifiedDate`	`string?`	Read	تاريخ التعديل.
`Modified`	`DateTime`	Read/Write	تاريخ /M (المعدل) ككائن DateTime مكتوب.
`Flags`	`AnnotationFlags`	Read/Write	علامات التعليق (/F entry) — تُستخدم كخزان تخزين لكل من الشكل الرقمي والشكل المكتوب.
`AnnotationFlags`	`AnnotationFlags`	Read/Write	اسم مستعار مكتوب للعلامات يكشف عن AnnotationFlags كخاصية.
`Action`	`PdfAction?`	Read/Write	الإجراء المرتبط بهذا التعليق (/A entry).
`Actions`	`PdfActionCollection`	Read	مجموعة من الإجراءات المرتبطة بهذا التعليق.
`Author`	`string?`	Read	مؤلف التعليق (/T entry).
`AnnotationState`	`string?`	Read	حالة التعليق (/State entry)، مثال
`AnnotationStateModel`	`string?`	Read	نموذج حالة التعليق (/StateModel 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 المستخدم من قبل مُعالج DOM.

الطرق

التوقيع	الوصف
`MarkupAnnotation(document: Document)`	منشئ مرتبط بالمستند لإنشاء تعليقة توضيحية لم تُرفق بعد بصفحة محددة؛ يضيفها المستدعون لاحقًا عبر page.Annotations.Add(annot).
`GetState()`	قراءة الإدخال /State في قاموس خصائص التعليقة.
`GetStateModel()`	قراءة الإدخال /StateModel، وربط الإدخال المفقود /entry بـ Undefined.
`SetMarkedState(marked: bool)`	تعيين /State إلى Marked أو Unmarked بالإضافة إلى /StateModel = Marked.
`SetReviewState(state: AnnotationState)`	تعيين حالة المراجعة.
`SetReviewState(state: AnnotationState, userName: string)`	تعيين حالة المراجعة مع اسم المستخدم للمراجع (مسجل في /T وفقًا لمواصفات PDF).
`ClearState()`	إزالة أي /State و /StateModel مسجلين.
`FindStateAnnotation()`	العثور على التعليقة المتعقبة للحالة المرتبطة بهذه التعليقة التوضيحية (أحدث تعليقة رد /IRT تحمل إدخال /State، وفقًا لـ PDF 32000 §12.5.6.3).
`Accept(visitor: AnnotationSelector)`	إرسال هذه التعليقة إلى التحميل الزائد Visit(SubType) المكتوب للزائر.
`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()`	استنساخ سطحي — ينسخ الحالة العددية/المشتركة بالمرجع.

انظر أيضًا

Aspose.PDF for .NET — مرجع API للمؤسسات