CommonFigureAnnotation
Vue d’ensemble
CommonFigureAnnotation est une classe dans Aspose.PDF FOSS pour .NET.
Hérite de : MarkupAnnotation.
Base commune pour les annotations carrées et circulaires — une figure dessinée à l’intérieur d’un rectangle, éventuellement en retrait par /RD (PDF 32000 §12.5.6.8).
Cette classe fournit 14 méthodes pour travailler avec des objets CommonFigureAnnotation dans des programmes .NET.
Les méthodes disponibles incluent : Accept, ChangeAfterResize, ClearState, Clone, FindStateAnnotation, Flatten, GetRectangle, GetState, GetStateModel, MarkupAnnotation, SetMarkedState, SetReviewState, et 2 méthodes supplémentaires.
Tous les membres publics sont accessibles à toute application .NET après l’installation du package Aspose.PDF FOSS for .NET.
Propriétés : Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState, et 44 autres.
Propriétés
| Nom | Type | Accès | Description |
|---|---|---|---|
Frame | Rectangle | Read/Write | Le rectangle de la figure dessinée — le rectangle d’annotation réduit par l’entrée /RD (différences de rectangle). |
CreationDate | System.DateTime | Read/Write | Horodatage de création enregistré dans /CreationDate. |
Opacity | double | Read/Write | Opacité (0..1) portée dans /CA. |
Popup | PopupAnnotation? | Read/Write | Annotation popup associée (/Popup). |
ReplyType | ReplyType | Read/Write | Relation de réponse à InReplyTo (/RT). |
RichText | string? | Read/Write | Contenu texte enrichi (/RC), formaté en XHTML. |
Subject | string? | Read/Write | Ligne d’objet (/Subj). |
Title | string? | Read/Write | Auteur / titre porté dans /T. |
AnnotationType | AnnotationType | Read | Le sous-type d’annotation. |
Rect | Rectangle? | Read/Write | Le rectangle d’annotation (position sur la page). |
Width | double | Read/Write | La largeur du rectangle d’annotation. |
Height | double | Read/Write | La hauteur du rectangle d’annotation. |
ActiveState | string? | Read/Write | État d’apparence actuellement actif (/AS entry). |
Alignment | TextAlignment | Read/Write | Alignement du texte (pour les annotations texte libre / widget contenant du texte enrichi). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Alignement horizontal, exposé en plus de Alignment ; les deux sont réglables indépendamment. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Remplacement d’alignement horizontal spécifique au texte. |
Appearance | AppearanceDictionary | Read | Dictionnaire d’apparence (/AP entry) — indexé par le nom du flux d’apparence (N, D, R). |
States | AppearanceDictionary | Read | Dictionnaire d’état d’apparence (le sous-dictionnaire par état de AP/N, par ex. |
NormalAppearance | XForm? | Read | L’apparence normale (/AP /N) de l’annotation sous forme de XForm, ou null si elle n’en a pas. |
UpdateAppearanceOnConvert | bool | Read/Write | Indique s’il faut régénérer le flux d’apparence lorsque l’annotation est enregistrée dans un document converti. |
UseFontSubset | bool | Read/Write | Indique si la police incorporée (le cas échéant) doit être sous‑ensemble. |
Contents | string? | Read/Write | Le contenu de l’annotation (texte). |
Border | Border? | Read/Write | Bordure de l’annotation. |
Color | Color | Read/Write | La couleur de la bordure de l’annotation (/C entry). |
InteriorColor | Color? | Read/Write | La couleur intérieure de l’annotation (/IC entry, pour les annotations cercle/carré/ligne). |
Name | string? | Read/Write | Le nom de l’annotation (identifiant unique — l’entrée /NM). |
FullName | string? | Read | Nom d’annotation pleinement qualifié. |
ModifiedDate | string? | Read | La date de modification. |
Modified | DateTime | Read/Write | La date /M (modifiée) sous forme de DateTime typé. |
Flags | AnnotationFlags | Read/Write | Drapeaux d’annotation (/F entry) — utilisés comme stockage sous‑jacent pour les formes int et typées. |
AnnotationFlags | AnnotationFlags | Read/Write | Alias typé de Flags exposant AnnotationFlags comme propriété. |
Action | PdfAction? | Read/Write | L’action associée à cette annotation (/A entry). |
Actions | PdfActionCollection | Read | Collection d’actions associées à cette annotation. |
Author | string? | Read | L’auteur de l’annotation (/T entry). |
AnnotationState | string? | Read | L’état de l’annotation (/State entry), par ex. |
AnnotationStateModel | string? | Read | Le modèle d’état de l’annotation (/StateModel entry), par ex. |
InReplyTo | Annotation? | Read/Write | L’annotation à laquelle celle-ci répond (/IRT entry). |
QuadPoints | Point[] | Read/Write | QuadPoints sous forme de tableau de valeurs Point. |
Characteristics | Characteristics | Read | Caractéristiques d’apparence (couleur de bordure, couleur d’arrière‑plan, rotation). |
PageIndex | int | Read | Indice basé sur 1 de la page qui possède cette annotation. |
Page | Page? | Read | La page qui possède cette annotation, ou null lorsqu’elle ne peut être résolue (par ex. |
VerticalAlignment | VerticalAlignment | Read/Write | Alignement vertical appliqué à ce paragraphe. |
Margin | MarginInfo? | Read/Write | Informations de marge extérieure appliquées à ce paragraphe. |
IsFirstParagraphInColumn | bool | Read/Write | Force le paragraphe à commencer une nouvelle colonne. |
IsKeptWithNext | bool | Read/Write | Garde ce paragraphe sur la même page que le suivant. |
IsInNewPage | bool | Read/Write | Force le paragraphe à commencer sur une nouvelle page. |
IsInLineParagraph | bool | Read/Write | Indicateur de paragraphe en ligne (ne commence pas une nouvelle ligne). |
HyperlinkText | string? | Read/Write | Cible de lien hypertexte de type chaîne héritée. |
Hyperlink | Hyperlink? | Read/Write | Décoration de lien hypertexte typée appliquée au paragraphe. |
ZIndex | int | Read/Write | Indice d’ordre Z utilisé par le rendu DOM. |
Méthodes
| Signature | Description |
|---|---|
MarkupAnnotation(document: Document) | Constructeur lié au document pour créer une annotation de balisage qui n’est pas encore attachée à une page spécifique ; les appelants l’ajoutent plus tard via page.Annotations.Add(annot). |
GetState() | Lire l’entrée /State du dictionnaire des propriétés de l’annotation. |
GetStateModel() | Lire l’entrée /StateModel, en mappant l’entrée manquante à Undefined. |
SetMarkedState(marked: bool) | Définir /State sur Marked ou Unmarked plus /StateModel = Marked. |
SetReviewState(state: AnnotationState) | Définir l’état de révision. |
ClearState() | Supprimer tout /State et /StateModel enregistrés. |
FindStateAnnotation() | Trouver l’annotation de suivi d’état liée à ce balisage (l’annotation de réponse /IRT la plus récente qui possède une entrée /State, selon PDF 32000 §12.5.6.3). |
Accept(visitor: AnnotationSelector) | Dispatcher cette annotation vers la surcharge typée Visit(SubType) du visiteur. |
GetRectangle(considerRotation: bool) | Rectangle englobant ajusté par considerRotation. |
ChangeAfterResize(transform: Matrix) | Ajuster la géométrie de l’annotation après que l’utilisateur a redimensionné la page ou le rectangle hôte. |
UpdateAppearances() | Régénérer le flux d’apparence normal (/AP /N) à partir de la géométrie et des couleurs actuelles de l’annotation. |
WriteXfdf(writer: System.Xml.XmlWriter) | Sérialiser cette annotation en tant qu’élément XFDF vers le writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | Aplatir cette annotation — rendre son apparence visuelle dans le contenu de la page et la supprimer du tableau des annotations de la page. |
Clone() | Clone superficiel — copie l’état scalaire/partagé par référence. |
