LineAnnotation
Overview
LineAnnotation is a class in Aspose.PDF FOSS for .NET.
Inherits from: MarkupAnnotation.
This class provides 17 methods for working with LineAnnotation objects in .NET programs.
Available methods include: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetRectangle, GetState, GetStateModel, LineAnnotation, MarkupAnnotation, SetMarkedState, and 4 additional methods.
All public members are accessible to any .NET application after installing the Aspose.PDF FOSS for .NET package.
Properties: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState, and 55 more.
Properties
| Name | Type | Access | Description |
|---|---|---|---|
AnnotationType | AnnotationType | Read | Always Line. |
Border | Border? | Read/Write | Border with width, style and dash pattern resolved from /BS. |
Starting | Point | Read/Write | Start point of the line (/L entry, first pair). |
Ending | Point | Read/Write | End point of the line (/L entry, second pair). |
CaptionOffset | Point | Read/Write | Caption offset from its anchor (/CO entry). |
CaptionPosition | CaptionPosition | Read/Write | Where the caption sits relative to the line (/CP entry). |
InteriorColor | Color? | Read/Write | Interior fill colour for the line’s endings (/IC entry). |
LeaderLine | double | Read/Write | Leader-line length perpendicular to the line (/LL entry). |
LeaderLineExtension | double | Read/Write | Leader-line extension past the line (/LLE entry). |
LeaderLineOffset | double | Read/Write | Leader-line offset from the line endpoint (/LLO entry). |
ShowCaption | bool | Read/Write | Whether the line’s caption is shown (/Cap entry). |
Measure | Measure | Read/Write | Measure-units metadata (/Measure entry). |
Intent | LineIntent | Read/Write | Gets or sets the intent. |
StartingStyle | LineEnding | Read/Write | Gets or sets the starting style. |
EndingStyle | LineEnding | Read/Write | Gets or sets the ending style. |
CreationDate | System.DateTime | Read/Write | Creation timestamp recorded in /CreationDate. |
Opacity | double | Read/Write | Opacity (0..1) carried in /CA. |
Popup | PopupAnnotation? | Read/Write | Associated popup annotation (/Popup). |
ReplyType | ReplyType | Read/Write | Reply relationship to InReplyTo (/RT). |
RichText | string? | Read/Write | Rich-text contents (/RC), XHTML-formatted. |
Subject | string? | Read/Write | Subject line (/Subj). |
Title | string? | Read/Write | Author / title carried in /T. |
Rect | Rectangle? | Read/Write | The annotation rectangle (position on page). |
Width | double | Read/Write | The width of the annotation rectangle. |
Height | double | Read/Write | The height of the annotation rectangle. |
ActiveState | string? | Read/Write | Currently-active appearance state (/AS entry). |
Alignment | TextAlignment | Read/Write | Text alignment (for free-text / widget annotations carrying rich text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Horizontal alignment, exposed in addition to Alignment; the two are independently settable. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Text-specific horizontal alignment override. |
Appearance | AppearanceDictionary | Read | Appearance dictionary (/AP entry) — keyed by appearance stream name (N, D, R). |
States | AppearanceDictionary | Read | Appearance-state dictionary (the per-state sub-dict of AP/N, e.g. |
NormalAppearance | XForm? | Read | The annotation’s normal (/AP /N) appearance as an XForm, or null when it has none. |
UpdateAppearanceOnConvert | bool | Read/Write | Whether to regenerate the appearance stream when the annotation is saved into a converted document. |
UseFontSubset | bool | Read/Write | Whether the embedded font (if any) should be subsetted. |
Contents | string? | Read/Write | The annotation contents (text). |
Color | Color | Read/Write | The annotation border color (/C entry). |
Name | string? | Read/Write | The annotation name (unique identifier — the /NM entry). |
FullName | string? | Read | Fully-qualified annotation name. |
ModifiedDate | string? | Read | The modification date. |
Modified | DateTime | Read/Write | The /M (modified) date as a typed DateTime. |
Flags | AnnotationFlags | Read/Write | Annotation flags (/F entry) — used as the storage backing for both the int and typed forms. |
AnnotationFlags | AnnotationFlags | Read/Write | Typed alias of Flags exposing AnnotationFlags as a property. |
Action | PdfAction? | Read/Write | The action associated with this annotation (/A entry). |
Actions | PdfActionCollection | Read | Collection of actions associated with this annotation. |
Author | string? | Read | The annotation author (/T entry). |
AnnotationState | string? | Read | The annotation state (/State entry), e.g. |
AnnotationStateModel | string? | Read | The annotation state model (/StateModel entry), e.g. |
InReplyTo | Annotation? | Read/Write | The annotation this one is replying to (/IRT entry). |
QuadPoints | Point[] | Read/Write | QuadPoints as an array of Point values. |
Characteristics | Characteristics | Read | Appearance characteristics (border color, background color, rotation). |
PageIndex | int | Read | 1-based index of the page that owns this annotation. |
Page | Page? | Read | The page that owns this annotation, or null when it can’t be resolved (e.g. |
VerticalAlignment | VerticalAlignment | Read/Write | Vertical alignment applied to this paragraph. |
Margin | MarginInfo? | Read/Write | Outer-margin info applied to this paragraph. |
IsFirstParagraphInColumn | bool | Read/Write | Force the paragraph to start a new column. |
IsKeptWithNext | bool | Read/Write | Keep this paragraph on the same page as the next one. |
IsInNewPage | bool | Read/Write | Force the paragraph to start on a new page. |
IsInLineParagraph | bool | Read/Write | Inline paragraph flag (does not start a new line). |
HyperlinkText | string? | Read/Write | Legacy string-typed hyperlink target. |
Hyperlink | Hyperlink? | Read/Write | Typed hyperlink decoration applied to the paragraph. |
ZIndex | int | Read/Write | Z-order index used by the DOM renderer. |
Methods
| Signature | Description |
|---|---|
LineAnnotation(page: Page, rect: Rectangle, start: Point, end: Point) | Calls LineAnnotation on this LineAnnotation instance. |
LineAnnotation(document: Document, start: Point, end: Point) | Document-bound LineAnnotation ctor. |
UpdateAppearances() | Regenerate the normal appearance (/AP /N) by stroking the line from Starting to Ending. |
UpdateAppearance(annotation: LineAnnotation) | Regenerate the appearance of annotation. |
ChangeAfterResize(transform: Matrix) | Apply a transform to the line’s start/end points after the page or container was resized. |
Accept(visitor: AnnotationSelector) | Calls Accept on this LineAnnotation instance. |
MarkupAnnotation(document: Document) | Document-bound ctor for creating a markup annotation that isn’t yet attached to a specific page; callers add it later via page.Annotations.Add(annot). |
GetState() | Read the /State entry on the annotation’s properties dictionary. |
GetStateModel() | Read the /StateModel entry, mapping the missing /entry to Undefined. |
SetMarkedState(marked: bool) | Set /State to Marked or Unmarked plus /StateModel = Marked. |
SetReviewState(state: AnnotationState) | Set the review state. |
ClearState() | Remove any recorded /State and /StateModel. |
FindStateAnnotation() | Find the state-tracking annotation linked to this markup (the most-recent /IRT reply annotation that carries a /State entry, per PDF 32000 §12.5.6.3). |
GetRectangle(considerRotation: bool) | Bounding rectangle adjusted by considerRotation. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serialize this annotation as an XFDF element to writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Flatten this annotation — render its visual appearance into the page content and remove it from the page’s annotations array. |
Clone() | Shallow clone — copies scalar/ref-shared state. |