تعليق الشاشة
نظرة عامة
ScreenAnnotation هي فئة في Aspose.PDF FOSS لـ .NET.
ترث من: Annotation.
تتيح لك فئة ScreenAnnotation إضافة تعليق شاشة إلى صفحة عن طريق توفير الصفحة، المستطيل، وملف الوسائط، وتعرض خصائص AnnotationType و Action و Title.
توفر هذه الفئة 8 طرق للعمل مع كائنات ScreenAnnotation في برامج .NET.
تشمل الطرق المتاحة: Accept، ChangeAfterResize، Clone، Flatten، GetRectangle، ScreenAnnotation، UpdateAppearances، WriteXfdf.
جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS for .NET.
الخصائص: Action، Actions، ActiveState، Alignment، AnnotationFlags، AnnotationState، وأكثر من 40 أخرى.
الخصائص
| الاسم | النوع | الوصول | الوصف |
|---|---|---|---|
AnnotationType | AnnotationType | Read | دائمًا شاشة. |
Action | PdfAction? | Read | إجراء تشغيل العرض (/A entry)، أو null عندما لا يتم تعيينه. |
Title | string? | Read/Write | العنوان/التسمية المعروضة في واجهة المشاهد (/T entry). |
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، للتعليقات الدائرية/المربعة/الخطية). |
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 كخاصية. |
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 | هدف الارتباط التشعبي من نوع السلسلة القديمة. |
Hyperlink | Hyperlink? | Read/Write | تزيين الارتباط التشعبي المكتوب المطبق على الفقرة. |
ZIndex | int | Read/Write | فهرس ترتيب Z المستخدم بواسطة مُعالج DOM. |
الطرق
| التوقيع | الوصف |
|---|---|
ScreenAnnotation(page: Page, rect: Rectangle, mediaFile: string) | إنشاء توضيح شاشة يشير إلى mediaFile. |
Accept(visitor: AnnotationSelector) | يستدعي Accept على هذه المثيلة من ScreenAnnotation. |
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() | استنساخ سطحي — ينسخ الحالة العددية/المشاركة بالمرجع. |