CommonFigureAnnotation
Panoramica
CommonFigureAnnotation è una classe in Aspose.PDF FOSS per .NET.
Eredita da: MarkupAnnotation.
Base comune per le annotazioni quadrato e cerchio — una figura disegnata all’interno di un rettangolo, eventualmente inserita da /RD (PDF 32000 §12.5.6.8).
Questa classe fornisce 14 metodi per lavorare con gli oggetti CommonFigureAnnotation nei programmi .NET.
I metodi disponibili includono: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetRectangle, GetState, GetStateModel, MarkupAnnotation, SetMarkedState, SetReviewState e 2 metodi aggiuntivi.
Tutti i membri pubblici sono accessibili da qualsiasi applicazione .NET dopo l’installazione del pacchetto Aspose.PDF FOSS for .NET.
Proprietà: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState e altre 44.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
Frame | Rectangle | Read/Write | Il rettangolo della figura disegnata — il rettangolo dell’annotazione ridotto dall’elemento /RD (differenze di rettangolo). |
CreationDate | System.DateTime | Read/Write | Timestamp di creazione registrato in /CreationDate. |
Opacity | double | Read/Write | Opacità (0..1) contenuta in /CA. |
Popup | PopupAnnotation? | Read/Write | Annotazione popup associata (/Popup). |
ReplyType | ReplyType | Read/Write | Relazione di risposta a InReplyTo (/RT). |
RichText | string? | Read/Write | Contenuti rich-text (/RC), formattati in XHTML. |
Subject | string? | Read/Write | Riga dell’oggetto (/Subj). |
Title | string? | Read/Write | Autore / titolo contenuto in /T. |
AnnotationType | AnnotationType | Read | Il sottotipo dell’annotazione. |
Rect | Rectangle? | Read/Write | Il rettangolo dell’annotazione (posizione nella pagina). |
Width | double | Read/Write | La larghezza del rettangolo dell’annotazione. |
Height | double | Read/Write | L’altezza del rettangolo dell’annotazione. |
ActiveState | string? | Read/Write | Stato di aspetto attualmente attivo (/AS entry). |
Alignment | TextAlignment | Read/Write | Allineamento del testo (per annotazioni free-text / widget che contengono rich text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Allineamento orizzontale, esposto oltre a Alignment; i due sono impostabili indipendentemente. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Sovrascrittura dell’allineamento orizzontale specifico per il testo. |
Appearance | AppearanceDictionary | Read | Dizionario di aspetto (/AP entry) — indicizzato per nome del flusso di aspetto (N, D, R). |
States | AppearanceDictionary | Read | Dizionario di stato di aspetto (il sotto-dizionario per stato di AP/N, ad es. |
NormalAppearance | XForm? | Read | L’aspetto normale (/AP /N) dell’annotazione come XForm, o null se non presente. |
UpdateAppearanceOnConvert | bool | Read/Write | Indica se rigenerare il flusso di aspetto quando l’annotazione viene salvata in un documento convertito. |
UseFontSubset | bool | Read/Write | Indica se il font incorporato (se presente) deve essere sottoposto a subset. |
Contents | string? | Read/Write | Il contenuto dell’annotazione (testo). |
Border | Border? | Read/Write | Bordo dell’annotazione. |
Color | Color | Read/Write | Il colore del bordo dell’annotazione (/C entry). |
InteriorColor | Color? | Read/Write | Il colore interno dell’annotazione (/IC entry, per annotazioni cerchio/quadrato/linea). |
Name | string? | Read/Write | Il nome dell’annotazione (identificatore unico — l’entry /NM). |
FullName | string? | Read | Nome dell’annotazione completamente qualificato. |
ModifiedDate | string? | Read | La data di modifica. |
Modified | DateTime | Read/Write | La data /M (modificata) come DateTime tipizzato. |
Flags | AnnotationFlags | Read/Write | Flag dell’annotazione (/F entry) — usati come supporto di memorizzazione sia per la forma int che per quella tipizzata. |
AnnotationFlags | AnnotationFlags | Read/Write | Alias tipizzato di Flags che espone AnnotationFlags come proprietà. |
Action | PdfAction? | Read/Write | L’azione associata a questa annotazione (/A entry). |
Actions | PdfActionCollection | Read | Collezione di azioni associate a questa annotazione. |
Author | string? | Read | L’autore dell’annotazione (/T entry). |
AnnotationState | string? | Read | Lo stato dell’annotazione (/State entry), ad es. |
AnnotationStateModel | string? | Read | Il modello di stato dell’annotazione (/StateModel entry), ad es. |
InReplyTo | Annotation? | Read/Write | L’annotazione a cui questa risponde (/IRT entry). |
QuadPoints | Point[] | Read/Write | QuadPoints come array di valori Point. |
Characteristics | Characteristics | Read | Caratteristiche di aspetto (colore del bordo, colore di sfondo, rotazione). |
PageIndex | int | Read | Indice basato su 1 della pagina che possiede questa annotazione. |
Page | Page? | Read | La pagina che possiede questa annotazione, o null se non può essere risolta (ad es. |
VerticalAlignment | VerticalAlignment | Read/Write | Allineamento verticale applicato a questo paragrafo. |
Margin | MarginInfo? | Read/Write | Informazioni di margine esterno applicate a questo paragrafo. |
IsFirstParagraphInColumn | bool | Read/Write | Forza il paragrafo a iniziare una nuova colonna. |
IsKeptWithNext | bool | Read/Write | Mantieni questo paragrafo sulla stessa pagina del successivo. |
IsInNewPage | bool | Read/Write | Forza il paragrafo a iniziare su una nuova pagina. |
IsInLineParagraph | bool | Read/Write | Flag di paragrafo inline (non inizia una nuova riga). |
HyperlinkText | string? | Read/Write | Obiettivo hyperlink di tipo stringa legacy. |
Hyperlink | Hyperlink? | Read/Write | Decorazione hyperlink tipizzata applicata al paragrafo. |
ZIndex | int | Read/Write | Indice Z-order usato dal renderer DOM. |
Metodi
| Signature | Description |
|---|---|
MarkupAnnotation(document: Document) | Costruttore legato al documento per creare un’annotazione di markup che non è ancora collegata a una pagina specifica; i chiamanti la aggiungono successivamente tramite page.Annotations.Add(annot). |
GetState() | Legge la voce /State nel dizionario delle proprietà dell’annotazione. |
GetStateModel() | Legge la voce /StateModel, mappando la /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() | Rimuove eventuali /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) | Inoltra 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 nel writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Appiattisce questa annotazione — rende il suo aspetto visivo nel contenuto della pagina e la rimuove dall’array delle annotazioni della pagina. |
Clone() | Clone superficiale — copia lo stato scalare/condivisione di riferimento. |
