التعليق
نظرة عامة
Annotation هي فئة في Aspose.PDF FOSS لـ .NET.
ترث من: BaseParagraph.
يمثل تعليقا على PDF.
هذه الفئة توفر 7 طرق للعمل مع كائنات Annotation في برامج .NET.
الطرق المتاحة تشمل: Accept، ChangeAfterResize، Clone، Flatten، GetRectangle، UpdateAppearances، WriteXfdf.
جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS for .NET.
الخصائص: Action، Actions، ActiveState، Alignment، AnnotationFlags، AnnotationState، وأكثر من 40 أخرى.
الخصائص
| الاسم | النوع | الوصول | الوصف |
|---|---|---|---|
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 | محتوى التعليق التوضيحي (نص). |
Opacity | double | Read/Write | شفافية التعليق التوضيحي (0.0 = شفاف، 1.0 = معتم). |
Border | Border? | Read/Write | حدود التعليق التوضيحي. |
Color | Color | Read/Write | لون حدود التعليق التوضيحي (/C entry). |
InteriorColor | Color? | Read/Write | لون داخلية التعليق التوضيحي (/IC entry، للتعليقات الدائرية/المربعة/الخطية). |
Title | string? | Read/Write | عنوان التعليق التوضيحي (المؤلف للتعليقات التوضيحية). |
Name | string? | Read/Write | اسم التعليق التوضيحي (معرف فريد — /NM entry). |
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 كخاصية. |
Action | PdfAction? | Read/Write | الإجراء المرتبط بهذا التعليق التوضيحي (/A entry). |
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 | هدف الارتباط التشعبي من نوع السلسلة (legacy). |
Hyperlink | Hyperlink? | Read/Write | تزيين الارتباط التشعبي المكتوب المطبق على الفقرة. |
ZIndex | int | Read/Write | فهرس ترتيب Z المستخدم بواسطة مُعالج DOM. |
الطرق
| التوقيع | الوصف |
|---|---|
Accept(visitor: AnnotationSelector) | إرسال هذه التعليقة إلى التحميل الزائد للنوع 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() | استنساخ سطحي — ينسخ الحالة المشتركة للمتغيرات/المراجع. |