הסבר
סקירה
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 | קריאה | סוג המשנה של ההערה. |
Rect | Rectangle? | קריאה/כתיבה | מלבן ההערה (מיקום בדף). |
Width | double | קריאה/כתיבה | רוחב מלבן ההערה. |
Height | double | קריאה/כתיבה | גובה מלבן ההערה. |
ActiveState | string? | קריאה/כתיבה | מצב המראה הפעיל כעת (ערך /AS). |
Alignment | TextAlignment | קריאה/כתיבה | יישור טקסט (להערות טקסט חופשי / וידג’ט שנושאות טקסט עשיר). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | קריאה/כתיבה | יישור אופקי, נחשף בנוסף ליישור; שני הערכים ניתנים להגדרה באופן עצמאי. |
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? | קריאה/כתיבה | תוכן ההערה (טקסט). |
Opacity | double | קריאה/כתיבה | שקיפות ההערה (0.0 = שקוף, 1.0 = אטום). |
Border | Border? | קריאה/כתיבה | גבול ההערה. |
Color | Color | קריאה/כתיבה | צבע גבול ההערה (ערך /C). |
InteriorColor | Color? | קריאה/כתיבה | צבע פנימי של ההערה (ערך /IC, עבור הערות עיגול/ריבוע/קו). |
Title | string? | קריאה/כתיבה | כותרת ההערה (מחבר עבור הערות סימון). |
Name | string? | קריאה/כתיבה | שם ההערה (מזהה ייחודי — ערך /NM). |
FullName | string? | קריאה | שם ההערה המלא. |
Subject | string? | קריאה/כתיבה | נושא ההערה (ערך /Subj). |
ModifiedDate | string? | קריאה | תאריך השינוי. |
Modified | DateTime | קריאה/כתיבה | תאריך /M (שונה) כ‑DateTime טיפוסי. |
Flags | AnnotationFlags | קריאה/כתיבה | דגלי ההערה (ערך /F) — משמשים כבסיס אחסון הן לצורת int והן לצורת הטיפוס. |
AnnotationFlags | AnnotationFlags | קריאה/כתיבה | כינוי טיפוסי של Flags החושף את AnnotationFlags כמאפיין. |
Action | PdfAction? | קריאה/כתיבה | הפעולה המשויכת להערה זו (ערך /A). |
Actions | PdfActionCollection | קריאה | אוסף של פעולות המשויכות להערה זו. |
Author | string? | קריאה | מחבר ההערה (ערך /T). |
AnnotationState | string? | קריאה | מצב ההערה (ערך /State), למשל |
AnnotationStateModel | string? | קריאה | מודל מצב ההערה (ערך /StateModel), למשל |
ReplyType | string? | קריאה | סוג התשובה (ערך /RT), למשל |
InReplyTo | Annotation? | קריאה/כתיבה | ההערה אליה מתבצעת תשובה זו (ערך /IRT). |
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 בו משתמש מנגנון הרינדור של DOM. |
שיטות
| חתימה | תיאור |
|---|---|
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() | שיבוט רדוד — מעתיק מצב סקלרי/משותף ברפרנס. |