InkAnnotation
نظرة عامة
InkAnnotation هي فئة في Aspose.PDF FOSS لـ .NET.
ترث من: MarkupAnnotation.
توفر هذه الفئة 17 طريقة للعمل مع كائنات InkAnnotation في برامج .NET.
الطرق المتاحة تشمل: Accept، ChangeAfterResize، ClearState، Clone، FindStateAnnotation، Flatten، GetRectangle، GetState، GetStateModel، InkAnnotation، MarkupAnnotation، SetMarkedState، و 3 طرق إضافية.
جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS for .NET.
الخصائص: Action، Actions، ActiveState، Alignment، AnnotationFlags، AnnotationState، و 45 أخرى.
الخصائص
| الاسم | النوع | الوصول | الوصف |
|---|---|---|---|
AnnotationType | AnnotationType | Read | دائمًا حبر. |
CapStyle | CapStyle | Read/Write | نمط طرف الضربة؛ مخزن فقط. |
InkList | IList<Point[]> | Read/Write | إدخال /InkList: كل مصفوفة داخلية تمثل مسار ضربة واحد. |
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. |
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. |
الطرق
| التوقيع | الوصف |
|---|---|
InkAnnotation(page: Page, rect: Rectangle, inkList: IList<Point[]>) | إنشاء تعليقة حبر مرتبطة بصفحة باستخدام مسارات الضربات المعطاة. |
InkAnnotation(document: Document, inkList: IList<Point[]>) | إنشاء تعليقة حبر مرتبطة بالمستند؛ يتم اشتقاق المستطيل من النقاط. |
InkAnnotation(page: Page, rect: Rectangle, inkList: System.Collections.IList) | إصدار قديم غير عام يتقبل IList من Point[]. |
ChangeAfterResize(transform: Matrix) | تحويل كل نقطة حبر وتحديث المستطيل المحيط. |
Accept(visitor: AnnotationSelector) | ينادي Accept على كائن InkAnnotation هذا. |
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). |
GetRectangle(considerRotation: bool) | المستطيل المحيط مُعدَّل بواسطة considerRotation. |
UpdateAppearances() | إعادة توليد تدفق المظهر العادي (/AP /N) من الهندسة والألوان الحالية للتعليقة. |
WriteXfdf(writer: System.Xml.XmlWriter) | تسلسل هذه التعليقة كعنصر XFDF إلى الكاتب (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | تسوية هذه التعليقة — رسم مظهرها البصري في محتوى الصفحة وإزالتها من مصفوفة تعليقات الصفحة. |
Clone() | استنساخ سطحي — ينسخ الحالة العددية/المشاركة بالمرجع. |
