THotPDF.SetLoadedFreeTextPlainText Method

Convertit explicitement une annotation FreeText chargée prise en charge en texte brut aligné à gauche et reconstruit son apparence normale

Déclaration

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

Unité : HPDFDoc · Disponible depuis la version 2.753.0

Paramètres

• PageIndex : index de la page chargée, à partir de zéro
• AnnotationIndex : index d’annotation sur cette page, à partir de zéro
• AText : caractères ASCII imprimables, avec CR, LF ou CR/LF pour les sauts de ligne explicites ; les tabulations, les autres caractères de contrôle et le texte non ASCII sont rejetés
• FontSize : taille finie en points PDF, supérieure à zéro et d’au plus 10 000, valeur par défaut 12

Conversion d’apparence

La méthode utilise du texte Helvetica noir et une bordure rectangulaire noire, conserve un fond device-color pris en charge et une géométrie de bordure pleine ou pointillée, et rogne le texte à un retrait de deux points à l’intérieur du rectangle d’annotation

Les lignes avancent de 1,2 fois la taille de police ; ni retour à la ligne automatique ni rétrécissement adaptatif, donc le texte hors du retrait est rogné

La conversion remplace /AP, met à jour /Contents et /DA, positionne /Q à zéro et supprime /RC, /DS et /AS ; l’ancien texte riche, la sélection de police, la couleur du texte, l’alignement et les états d’apparence sont volontairement remplacés

Les changements d’annotation, d’apparence et de page sont enregistrés pour l’enregistrement incrémentiel et le cache de rendu de la page est invalidé ; l’enregistrement par réécriture préserve aussi la nouvelle apparence

Entrées prises en charge et erreurs

L’annotation doit exister avec le sous-type FreeText et un rectangle fini plus large et plus haut que quatre points

Les callouts, différences ou retraits de rectangle, effets de bordure, entrée de rotation, intention non FreeText, annotations non opaques, bordures arrondies et styles de bordure autres que pleine ou pointillée sont rejetés avec EArgumentException

Les composantes de fond DeviceGray, DeviceRGB et DeviceCMYK doivent rester entre zéro et un ; les largeurs de bordure et patterns de tirets doivent être valides, finis et non négatifs, et un pattern de tirets non vide tout zéro est rejeté

Les entrées non prises en charge sont validées avant de remplacer l’annotation ou son apparence

Exemple

Pour un document chargé dont la première annotation de la page zéro est une annotation FreeText prise en charge

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

API associées

SetLoadedAnnotationContents ne change que la chaîne de contenus stockée et préserve une apparence existante

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Accueil