הערת דיו

סקירה

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	תמיד Ink.
`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).
`FullName`	`string?`	Read	שם ההערה המלא.
`ModifiedDate`	`string?`	Read	תאריך השינוי.
`Modified`	`DateTime`	Read/Write	תאריך /M (modified) כ‑DateTime טיפוסי.
`Flags`	`AnnotationFlags`	Read/Write	דגלי ההערה (/F entry) — משמשים כאחסון עבור הצורה השלם והטיפוסית.
`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.

שיטות

Signature	Description
`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)`	בונה (ctor) הקשור למסמך ליצירת הערת סימון שעדיין לא מחוברת לעמוד ספציפי; המתקשרים מוסיפים אותה מאוחר יותר באמצעות 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 אל writer (PDF 32000 §12.7.8 / XFDF 3.0).
`Flatten()`	שטח את ההערה הזו — רנדר את המראה החזותי שלה לתוך תוכן העמוד והסר אותה ממערך ההערות של העמוד.
`Clone()`	שיבוט רדוד — מעתיק מצב סקלרי/משותף ברפרנס.

ראה גם

Aspose.PDF for .NET — תיעוד API ארגוני