הסימון

סקירה

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 נוספים.

מאפיינים

Name	Type	Access	Description
`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 (modified) כ‑DateTime טיפוסי.
`Flags`	`AnnotationFlags`	Read/Write	דגלי ההערה (/F entry) — משמשים כמקור אחסון הן לצורת int והן לצורת הטיפוס.
`AnnotationFlags`	`AnnotationFlags`	Read/Write	כינוי טיפוסי של Flags החושף את 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)`	בונה קשור למסמך ליצירת markup annotation שעדיין לא מצורף לעמוד ספציפי; המתקשרים מוסיפים אותו מאוחר יותר באמצעות 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)`	שלח את ההערה הזו ל-overload המוגדר Visit(SubType) של visitor.
`GetRectangle(considerRotation: bool)`	ריבוע גבול מותאם על ידי considerRotation.
`ChangeAfterResize(transform: Matrix)`	התאם את גאומטריית ההערה לאחר שהמשתמש שינה את גודל העמוד או ריבוע המארח.
`UpdateAppearances()`	צור מחדש את זרם המראה הרגיל (/AP /N) מהגאומטריה והצבעים הנוכחיים של ההערה.
`WriteXfdf(writer: System.Xml.XmlWriter)`	סדר (serialize) את ההערה הזו כאלמנט XFDF אל writer (PDF 32000 §12.7.8 / XFDF 3.0).
`Flatten()`	שטח את ההערה הזו — רנדר את המראה החזותי שלה לתוך תוכן העמוד והסר אותה ממערך ההערות של העמוד.
`Clone()`	שיבוט רדוד — מעתיק מצב סקלרי/משותף ברפרנס.

ראה גם

Aspose.PDF עבור .NET — הפנייה ל-Enterprise API