THotPDF.SetLoadedFreeTextText Method
Remplace l'apparence normale d'une annotation FreeText chargée à l'aide de polices Unicode embarquées, de texte enrichi optionnel et d'une transaction de graphe atomique
Déclaration
procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');Options
Initialisez le record avec THPDFLoadedTextAppearanceOptions.Default avant de modifier des champs individuels
| Champ | Comportement |
|---|---|
| FontName, FontStyle, FontSize | Police principale, style et taille en points ; les défauts sont Arial, regular et 12 points |
| TextColor, Alignment, Padding | Couleur du texte brut, alignement gauche/centre/droite et padding en points ; les défauts sont noir, gauche et 2 points |
| Opacity, Rotation | Opacité dans [0,1] et rotation par multiples de 90 degrés |
| OverflowPolicy | THPDFLoadedTextOverflowPolicy : ltopReject rejette le débordement, ltopClip le rogne et ltopShrinkToFit réessaie avec des polices plus petites |
| MinFontSize | Borne inférieure pour la réduction, 4 points par défaut |
| MaxTextUnits | Budget d'entrée et de texte brut, 1,048,576 unités UTF-16 par défaut ; l'entrée enrichie est limitée à quatre fois ce budget |
Comportement
AText fournit du texte Unicode brut ; un RichContent UTF-8 non vide utilise à la place l'importeur HTML et le DefaultStyle CSS optionnel, puis dérive /Contents à partir du texte généré
L'apparence générée copie les polices embarquées et les mappings ToUnicode dans le document chargé, si bien que l'enregistrement, l'aplatissement et l'extraction de texte conservent son texte Unicode
La méthode hérite des chaînes de fontes de secours configurées, de ShapingFeatures, des commutateurs d'auto-shaping arabe, syriaque, N'Ko, Adlam et Hanifi Rohingya, et des sélections GSUB de script et de langue ; chaque tentative de shrink-to-fit utilise les mêmes réglages sans modifier la configuration de l'appelant
Elle préserve les arrière-plans pris en charge, les bordures pleines/pointillées, les insets de rectangle et la géométrie de callout à deux/trois points, et synchronise les métadonnées /AP, /Contents, /RC, /DS, /CA, /Q et de rotation
Une géométrie invalide, des glyphes de texte brut non résolus, des bordures nuage, des limites de ressources et un débordement rejeté lèvent une exception et annulent la mise à jour entière ; les transactions de graphe externes existantes restent actives
Le texte enrichi suit le sous-ensemble HTML/CSS pris en charge ; les ressources externes sont désactivées et des tailles de police CSS fixes peuvent empêcher le shrink-to-fit de réduire des runs individuels
Chaque rédacteur d'apparence accepte au plus 256 sélections distinctes de polices de shaping et 64 Mio de données brutes de polices cumulées ; dépasser l'une ou l'autre limite rejette la mise à jour et préserve l'annotation d'origine
API associées
- SetLoadedFreeTextRichText utilise ce pipeline d'apparences avec le clipping du débordement
- SetLoadedFreeTextPlainText conserve son contrat ASCII d'origine
- SetLoadedAnnotationContents ne modifie que le contenu stocké