FreeTextAnnotation
Panoramica
FreeTextAnnotation è una classe in Aspose.PDF FOSS per .NET. Eredita da: MarkupAnnotation.
Questa classe fornisce 19 metodi per lavorare con oggetti FreeTextAnnotation nei programmi .NET. I metodi disponibili includono: Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, FreeTextAnnotation, GetRectangle, GetState, GetStateModel, MarkupAnnotation, SetMarkedState e 4 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione .NET dopo aver installato il pacchetto Aspose.PDF FOSS per .NET. Proprietà: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState e 55 in più.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
DefaultAppearance | string? | Lettura/Scrittura | La stringa /DA di aspetto predefinito. |
DefaultAppearanceObject | DefaultAppearance | Lettura | L’oggetto fortemente tipizzato di aspetto predefinito che supporta DefaultAppearance. |
DefaultStyle | string? | Lettura/Scrittura | Stile rich-text predefinito in linea trasportato in /DS. |
RichText | string? | Lettura/Scrittura | Stringa rich text (XHTML) per l’annotazione (/RC entry). |
AnnotationType | AnnotationType | Lettura | Sempre FreeText. |
Callout | Point[]? | Lettura/Scrittura | Polilinea di richiamo (/CL entry, PDF 32000 §12.5.6.6 — Testo libero). |
Justification | Justification | Lettura/Scrittura | Allineamento del testo renderizzato (/Q: 0=Sinistra, 1=Centro, 2=Destra). |
Intent | FreeTextIntent | Lettura/Scrittura | Intento di testo libero (/IT — FreeTextCallout / FreeTextTypeWriter). |
StartingStyle | LineEnding | Lettura/Scrittura | Stile di terminazione della riga iniziale (/LE prima voce; solo intento di richiamo). |
EndingStyle | LineEnding | Lettura/Scrittura | Stile di terminazione della riga finale (/LE seconda voce; solo intento di richiamo). |
Rotate | Aspose.Pdf.Rotation | Lettura/Scrittura | Rotazione della pagina del testo renderizzato (/Rotate). |
TextRectangle | Rectangle? | Lettura/Scrittura | Rettangolo interno del testo (/RD inserito da /Rect). |
TextStyle | TextStyle | Lettura/Scrittura | Stile di testo raggruppato (font / size / colour / alignment) applicato durante il rendering dei contenuti rich-text. |
CreationDate | System.DateTime | Lettura/Scrittura | Timestamp di creazione registrato in /CreationDate. |
Opacity | double | Lettura/Scrittura | Opacità (0..1) riportata in /CA. |
Popup | PopupAnnotation? | Lettura/Scrittura | Annotazione popup associata (/Popup). |
ReplyType | ReplyType | Lettura/Scrittura | Rispondi alla relazione con InReplyTo (/RT). |
Subject | string? | Lettura/Scrittura | Riga oggetto (/Subj). |
Title | string? | Lettura/Scrittura | Autore / titolo riportato in /T. |
Rect | Rectangle? | Lettura/Scrittura | Il rettangolo di annotazione (posizione nella pagina). |
InnerRect | Rectangle? | Lettura | Il rettangolo di annotazione rientrato dall’entrata /RD (differenze del rettangolo) — la regione 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 (voce /AS). |
Alignment | TextAlignment | Lettura/Scrittura | Allineamento del testo (per annotazioni di testo libero / widget che contengono testo ricco). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lettura/Scrittura | Allineamento orizzontale (esposto in aggiunta a Alignment; i due sono impostabili indipendentemente). |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Lettura/Scrittura | Sovrascrittura dell’allineamento orizzontale specifico del 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, oppure 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) deve essere ridotto a sottoinsieme. |
Contents | string? | Lettura/Scrittura | I contenuti 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 unico — la voce /NM). |
FullName | string? | Lettura | Nome dell’annotazione completamente 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 int e tipizzate. |
AnnotationFlags | AnnotationFlags | Lettura/Scrittura | Alias tipizzato di Flags corrispondente alla superficie pubblica 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 (voce /T). |
AnnotationState | string? | Lettura | Lo stato dell’annotazione (voce /State), ad es. |
AnnotationStateModel | string? | Lettura | Il modello di stato dell’annotazione (voce /StateModel), ad es. |
InReplyTo | Annotation? | Lettura/Scrittura | L’annotazione a cui questa 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 a base 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 sul margine esterno applicate a questo paragrafo. |
IsFirstParagraphInColumn | bool | Lettura/Scrittura | Forza il paragrafo ad iniziare una nuova colonna. |
IsKeptWithNext | bool | Lettura/Scrittura | Mantieni questo paragrafo sulla stessa pagina del successivo. |
IsInNewPage | bool | Lettura/Scrittura | Forza l’inizio del paragrafo su una nuova pagina. |
IsInLineParagraph | bool | Lettura/Scrittura | Flag del paragrafo inline (non inizia una nuova riga). |
HyperlinkText | string? | Lettura/Scrittura | Target del collegamento ipertestuale di tipo stringa legacy. |
Hyperlink | Hyperlink? | Lettura/Scrittura | Decorazione del collegamento ipertestuale tipizzata applicata al paragrafo. |
ZIndex | int | Lettura/Scrittura | Indice Z-order utilizzato dal renderer DOM. |
Metodi
| Firma | Descrizione |
|---|---|
FreeTextAnnotation(page: Page, rect: Rectangle, appearance: DefaultAppearance) | Crea un nuovo FreeTextAnnotation con un aspetto predefinito. |
FreeTextAnnotation(document: Document, appearance: DefaultAppearance) | Costruttore legato al documento per creare un FreeTextAnnotation che non è ancora collegato a una pagina specifica; il chiamante lo aggiunge tramite page.Annotations.Add(annot). |
SetTextStyle(textStyles: RichTextFontStyles, fontName: string, fontSize: double, fontColor: System.Drawing.Color) | Applica i flag di stile all’intero text run. |
SetTextStyle(fromInd: int, toInd: int, textStyles: RichTextFontStyles) | Applica i flag di stile rich-text alla sottostringa [fromInd, toInd). |
Accept(visitor: AnnotationSelector) | Chiama Accept(visitor) su questa istanza di FreeTextAnnotation. |
MarkupAnnotation(document: Document) | Ctor legato al documento per creare un’annotazione markup che non è ancora collegata a una pagina specifica; i chiamanti la aggiungono successivamente tramite page.Annotations.Add(annot). |
GetState() | Leggi la voce /State nel dizionario delle proprietà dell’annotazione. |
GetStateModel() | Leggi la voce /StateModel, mappando la voce mancante /entry su Undefined. |
SetMarkedState(marked: bool) | Imposta /State su Marked o Unmarked più /StateModel = Marked. |
SetReviewState(state: AnnotationState) | Imposta lo stato di revisione. |
SetReviewState(state: AnnotationState, userName: string) | Imposta lo stato della revisione insieme al nome utente del revisore (registrato in /T secondo la specifica PDF). |
ClearState() | Rimuovi qualsiasi /State registrato e /StateModel. |
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). |
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 colours attuali dell’annotazione. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serializza questa annotazione come elemento XFDF nello scrittore (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Appiattisci questa annotazione — rendi il suo aspetto visivo nel contenuto della pagina e rimuovila dall’array delle annotazioni della pagina. |
Clone() | Clone superficiale — copia lo stato scalare/condivisione di riferimento. |