TextMarkupAnnotation
Panoramica
TextMarkupAnnotation è una classe in Aspose.PDF FOSS per .NET. Eredita da: MarkupAnnotation.
Classe base per le annotazioni di markup del testo (Highlight, Underline, StrikeOut, Squiggly) — quelle la cui geometria è un insieme di QuadPoints sul testo della pagina.
Questa classe fornisce 17 metodi per lavorare con gli oggetti TextMarkupAnnotation nei programmi .NET. I metodi disponibili includono: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetMarkedText, GetMarkedTextFragments, GetRectangle, GetState, GetStateModel, MarkupAnnotation, e 5 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione .NET dopo l’installazione del pacchetto Aspose.PDF FOSS per .NET. Proprietà: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState, e 44 in più.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
CreationDate | System.DateTime | Lettura/Scrittura | Timestamp di creazione registrato in /CreationDate. |
Opacity | double | Lettura/Scrittura | Opacità (0..1) trasportata in /CA. |
Popup | PopupAnnotation? | Lettura/Scrittura | Annotazione popup associata (/Popup). |
ReplyType | ReplyType | Lettura/Scrittura | Relazione di risposta a InReplyTo (/RT). |
RichText | string? | Lettura/Scrittura | Contenuti Rich-text (/RC), formattati in XHTML. |
Subject | string? | Lettura/Scrittura | Riga dell’oggetto (/Subj). |
Title | string? | Lettura/Scrittura | Autore / titolo riportato in /T. |
AnnotationType | AnnotationType | Lettura | Il sottotipo di annotazione. |
Rect | Rectangle? | Lettura/Scrittura | Il rettangolo dell’annotazione (posizione nella pagina). |
InnerRect | Rectangle? | Lettura | Il rettangolo dell’annotazione inserito dall’entrata /RD (differenze di rettangolo) — la zona effettivamente disegnata all’interno di Rect. |
Width | double | Lettura/Scrittura | La larghezza del rettangolo di annotazione. |
Height | double | Lettura/Scrittura | L’altezza del rettangolo di annotazione. |
ActiveState | string? | Lettura/Scrittura | Stato di aspetto attualmente attivo (/AS entry). |
Alignment | TextAlignment | Lettura/Scrittura | Allineamento del testo (per annotazioni di testo libero / widget che contengono testo formattato). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lettura/Scrittura | Allineamento orizzontale (Aspose.Pdf lo espone oltre all’Allineamento; i due sono impostabili indipendentemente). |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lettura/Scrittura | Sovrascrittura dell’allineamento orizzontale specifica per il testo. |
Appearance | AppearanceDictionary | Lettura | Dizionario di aspetto (/AP entry) — indicizzato per nome del flusso di aspetto (N, D, R). |
States | AppearanceDictionary | Lettura | Dizionario di stato di aspetto (il sotto-dizionario per stato di AP/N, ad es. |
NormalAppearance | XForm? | Lettura | L’aspetto normale (/AP /N) dell’annotazione come XForm, o null se non ne ha. |
UpdateAppearanceOnConvert | bool | Lettura/Scrittura | Indica se rigenerare lo stream di aspetto quando un’annotazione viene salvata in un documento convertito. |
UseFontSubset | bool | Lettura/Scrittura | Indica se il font incorporato (se presente) debba essere sottoposto a subset. |
Contents | string? | Lettura/Scrittura | Il contenuto dell’annotazione (testo). |
Border | Border? | Lettura/Scrittura | Bordo dell’annotazione. |
Color | Color | Lettura/Scrittura | Il colore del bordo dell’annotazione (/C entry). |
InteriorColor | Color? | Lettura/Scrittura | Il colore interno dell’annotazione (/IC entry, per annotazioni cerchio/quadrato/linea). |
Name | string? | Lettura/Scrittura | Il nome dell’annotazione (identificatore univoco — l’entry /NM). |
FullName | string? | Lettura | Nome dell’annotazione pienamente qualificato. |
ModifiedDate | string? | Lettura | La data di modifica. |
Modified | DateTime | Lettura/Scrittura | La data /M (modificata) come DateTime tipizzato. |
Flags | AnnotationFlags | Lettura/Scrittura | Flag di annotazione (/F entry) — usati come supporto di archiviazione per le forme sia int che tipizzate. |
AnnotationFlags | AnnotationFlags | Lettura/Scrittura | Alias tipizzato di Flags corrispondente alla superficie pubblica Aspose.Pdf che espone AnnotationFlags come proprietà. |
Action | PdfAction? | Lettura/Scrittura | L’azione associata a questa annotazione (/A entry). |
Actions | PdfActionCollection | Lettura | Raccolta di azioni associate a questa annotazione. |
Author | string? | Lettura | L’autore dell’annotazione (/T entry). |
AnnotationState | string? | Lettura | Lo stato dell’annotazione (/State entry), ad es. |
AnnotationStateModel | string? | Lettura | Il modello di stato dell’annotazione (/StateModel entry), ad es. |
InReplyTo | Annotation? | Lettura/Scrittura | L’annotazione a cui questo risponde (/IRT entry). |
QuadPoints | Point[] | Lettura/Scrittura | QuadPoints come un array di valori Point. |
Characteristics | Characteristics | Lettura | Caratteristiche di aspetto (colore del bordo, colore di sfondo, rotazione). |
PageIndex | int | Lettura | Indice basato su 1 della pagina che possiede questa annotazione. |
Page | Page? | Lettura | La pagina che possiede questa annotazione, o null quando non può essere risolta (ad es. |
VerticalAlignment | VerticalAlignment | Lettura/Scrittura | Allineamento verticale applicato a questo paragrafo. |
Margin | MarginInfo | Lettura/Scrittura | Informazioni di margine esterno applicate a questo paragrafo. |
IsFirstParagraphInColumn | bool | Lettura/Scrittura | Forza il paragrafo a iniziare una nuova colonna. |
IsKeptWithNext | bool | Lettura/Scrittura | Mantieni questo paragrafo sulla stessa pagina del successivo. |
IsInNewPage | bool | Lettura/Scrittura | Forza il paragrafo a iniziare su una nuova pagina. |
IsInLineParagraph | bool | Lettura/Scrittura | Flag di paragrafo in linea (non avvia una nuova riga). |
HyperlinkText | string? | Lettura/Scrittura | Obiettivo del collegamento ipertestuale di tipo stringa legacy. |
Hyperlink | Hyperlink? | Lettura/Scrittura | Decorazione del collegamento ipertestuale tipizzato applicata al paragrafo. |
ZIndex | int | Lettura/Scrittura | Indice Z-order utilizzato dal renderer DOM. |
Metodi
| Firma | Descrizione |
|---|---|
TextMarkupAnnotation(document: Document) | Ctor legato al documento (aggiunto a una pagina in seguito). |
GetMarkedText() | Il testo coperto dal QuadPoints di questa annotazione, con il testo di ciascun quad (ogni riga evidenziata) separato da NewLine. |
GetMarkedTextFragments() | I frammenti di testo della pagina coperti dal QuadPoints di questa annotazione — un frammento ritagliato per ogni frammento sorgente che ciascun quad sovrappone. |
MarkupAnnotation(document: Document) | Ctor legato al documento per creare un’annotazione markup che non è ancora collegata a una pagina specifica; i chiamanti la aggiungono in seguito tramite page.Annotations.Add(annot). |
GetState() | Leggi la voce /State nel dizionario delle proprietà dell’annotazione. |
GetStateModel() | Leggi la voce /StateModel, mappando la voce /entry mancante a Undefined. |
SetMarkedState(marked: bool) | Imposta /State su Marked o Unmarked più /StateModel = Marked. |
SetReviewState(state: AnnotationState) | Imposta lo stato di revisione. |
ClearState() | Rimuovi qualsiasi /State e /StateModel registrati. |
FindStateAnnotation() | Trova l’annotazione di tracciamento dello stato collegata a questo markup (l’annotazione di risposta /IRT più recente che contiene una voce /State, secondo PDF 32000 §12.5.6.3). |
Accept(visitor: AnnotationSelector) | Invia questa annotazione al sovraccarico tipizzato Visit(SubType) del visitor. |
GetRectangle(considerRotation: bool) | Rettangolo di delimitazione regolato da considerRotation. |
ChangeAfterResize(transform: Matrix) | Regola la geometria dell’annotazione dopo che l’utente ha ridimensionato la pagina o il rettangolo ospite. |
UpdateAppearances() | Rigenera lo stream di aspetto normale (/AP /N) dalla geometria e dai colori attuali dell’annotazione. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serializza questa annotazione come elemento XFDF al writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Appiattisci questa annotazione — rendi il suo aspetto visivo nel contenuto della pagina e rimuovilo dall’array delle annotazioni della pagina. |
Clone() | Clone superficiale — copia lo stato scalare/condiviso per riferimento. |