Bloc de texte masqué dans un fichier PDF

Dans ce didacticiel, nous expliquerons comment créer un bloc de texte masqué dans un fichier PDF à l’aide de la bibliothèque Aspose.PDF pour .NET. Un bloc de texte masqué est un texte flottant qui devient visible lorsque le curseur de la souris survole une zone spécifique. Nous passerons en revue le processus étape par étape de création du bloc de texte masqué à l’aide du code source C# fourni.

Exigences

Avant de commencer, assurez-vous d’avoir les éléments suivants :

  • La bibliothèque Aspose.PDF pour .NET installée.
  • Une compréhension de base de la programmation C#.

Étape 1 : configurer le répertoire de documents

Tout d’abord, vous devez définir le chemin d’accès au répertoire dans lequel vous souhaitez enregistrer le fichier PDF généré. Remplacer"YOUR DOCUMENT DIRECTORY" dans ledataDirvariable avec le chemin d’accès au répertoire souhaité.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Étape 2 : Créer un exemple de document

Dans cette étape, nous créons un exemple de document PDF et y ajoutons un fragment de texte. Le fragment de texte servira de déclencheur pour afficher le bloc de texte masqué.

string outputFile = dataDir + "TextBlock_HideShow_MouseOverOut_out.pdf";
Document doc = new Document();
doc.Pages.Add().Paragraphs.Add(new TextFragment("Move the mouse cursor here to display floating text"));
doc.Save(outputFile);

Étape 3 : ouvrir le document

Maintenant, nous ouvrons le document créé précédemment en utilisant leDocument classe.

Document document = new Document(outputFile);

Étape 4 : Trouver le fragment de texte

Nous utilisons unTextFragmentAbsorber objet pour trouver le fragment de texte qui déclenchera l’affichage du bloc de texte masqué. Dans ce cas, nous recherchons le texte exact « Déplacez le curseur de la souris ici pour afficher le texte flottant ».

TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display floating text");
document.Pages.Accept(absorb);
TextFragmentCollection textFragments = absorb.TextFragments;
TextFragment fragment = textFragments[1];

Étape 5 : Créer le champ de texte masqué

Nous créons unTextBoxField objet pour représenter le champ de texte masqué. Ce champ contiendra le texte qui devient visible lorsque le curseur de la souris survole le texte du déclencheur.

TextBoxField floatingField = new TextBoxField(fragment.Page, new Rectangle(100, 700, 220, 740));
floatingField.Value = "This is the \"floating text field\".";
floatingField. ReadOnly = true;
floatingField.Flags |= AnnotationFlags.Hidden;
floatingField.PartialName = "FloatingField_1";
floatingField.DefaultAppearance = new DefaultAppearance("Helv", 10, System.Drawing.Color.Blue);
floatingField.Characteristics.Background = System.Drawing.Color.LightBlue;
floatingField.Characteristics.Border = System.Drawing.Color.DarkBlue;
floatingField.Border = new Border(floatingField);
floatingField.Border.Width = 1;
floatingField. Multiline = true;

Étape 6 : ajouter le champ de texte masqué au document

Nous ajoutons le champ de texte masqué à la collection de formulaires du document.

document.Form.Add(floatingField);

Étape 7 : Créer le bouton invisible

Nous créons un champ de bouton invisible qui sera positionné au-dessus du fragment de texte déclencheur. Ce champ de bouton aura des actions associées aux événements d’entrée et de sortie de la souris.

ButtonField buttonField = new ButtonField(fragment.Page, fragment.Rectangle);
buttonField.Actions.OnEnter = new HideAction(floatingField, false);
buttonField.Actions.OnExit = new HideAction(floatingField);
document.Form.Add(buttonField);

Étape 8 : Enregistrez le document

Enfin, nous sauvegardons le document modifié avec le bloc de texte masqué.

document. Save(outputFile);

Exemple de code source pour un bloc de texte caché utilisant Aspose.PDF pour .NET

// Le chemin d'accès au répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string outputFile = dataDir + "TextBlock_HideShow_MouseOverOut_out.pdf";
// Créer un exemple de document avec du texte
Document doc = new Document();
doc.Pages.Add().Paragraphs.Add(new TextFragment("Move the mouse cursor here to display floating text"));
doc.Save(outputFile);
// Ouvrir un document avec du texte
Document document = new Document(outputFile);
// Créez un objet TextAbsorber pour trouver toutes les phrases correspondant à l'expression régulière
TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display floating text");
// Acceptez l'absorbeur pour les pages du document
document.Pages.Accept(absorber);
// Obtenez le premier fragment de texte extrait
TextFragmentCollection textFragments = absorber.TextFragments;
TextFragment fragment = textFragments[1];
// Créer un champ de texte masqué pour le texte flottant dans le rectangle spécifié de la page
TextBoxField floatingField = new TextBoxField(fragment.Page, new Rectangle(100, 700, 220, 740));
// Définir le texte à afficher comme valeur de champ
floatingField.Value = "This is the \"floating text field\".";
// Nous vous recommandons de définir le champ en lecture seule pour ce scénario.
floatingField.ReadOnly = true;
// Définir l'indicateur « caché » pour rendre le champ invisible à l'ouverture du document
floatingField.Flags |= AnnotationFlags.Hidden;
// Définir un nom de champ unique n'est pas nécessaire mais autorisé
floatingField.PartialName = "FloatingField_1";
// Définir les caractéristiques de l'apparence du champ n'est pas nécessaire mais le rend meilleur
floatingField.DefaultAppearance = new DefaultAppearance("Helv", 10, System.Drawing.Color.Blue);
floatingField.Characteristics.Background = System.Drawing.Color.LightBlue;
floatingField.Characteristics.Border = System.Drawing.Color.DarkBlue;
floatingField.Border = new Border(floatingField);
floatingField.Border.Width = 1;
floatingField.Multiline = true;
// Ajouter un champ de texte au document
document.Form.Add(floatingField);
// Créer un bouton invisible sur la position du fragment de texte
ButtonField buttonField = new ButtonField(fragment.Page, fragment.Rectangle);
// Créez une nouvelle action de masquage pour le champ spécifié (annotation) et l'indicateur d'invisibilité.
//(Vous pouvez également désigner le champ flottant par son nom si vous l'avez spécifié ci-dessus.)
// Ajouter des actions sur l'entrée/sortie de la souris dans le champ du bouton invisible
buttonField.Actions.OnEnter = new HideAction(floatingField, false);
buttonField.Actions.OnExit = new HideAction(floatingField);
// Ajouter un champ de bouton au document
document.Form.Add(buttonField);
// Enregistrer le document
document.Save(outputFile);

Conclusion

Dans ce didacticiel, vous avez appris à créer un bloc de texte masqué à l’aide de la bibliothèque Aspose.PDF pour .NET. En suivant le guide étape par étape, vous pouvez générer un document PDF avec un champ de texte masqué qui devient visible lorsque le curseur de la souris survole une zone spécifique. Vous pouvez personnaliser l’apparence et le comportement du bloc de texte masqué en fonction de vos besoins.

FAQ

Q : Quel est l’objectif du didacticiel « Bloc de texte caché dans un fichier PDF » ?

R : Le didacticiel « Bloc de texte masqué dans un fichier PDF » explique comment créer un bloc de texte masqué dans un fichier PDF à l’aide de la bibliothèque Aspose.PDF pour .NET. Un bloc de texte masqué est un texte flottant qui devient visible lorsque le curseur de la souris survole une zone spécifique. Ce didacticiel fournit un guide étape par étape utilisant le code source C#.

Q : Pourquoi voudrais-je créer un bloc de texte masqué dans un fichier PDF ?

R : La création d’un bloc de texte masqué peut être utile pour les documents PDF interactifs dans lesquels vous souhaitez fournir des informations supplémentaires ou un contexte qui ne deviennent visibles que lorsqu’un utilisateur passe le curseur de sa souris sur une zone désignée.

Q : Comment configurer le répertoire de documents ?

R : Pour configurer le répertoire de documents :

  1. Remplacer"YOUR DOCUMENT DIRECTORY" dans ledataDir variable avec le chemin d’accès au répertoire dans lequel vous souhaitez enregistrer le fichier PDF généré.

Q : Comment puis-je créer un exemple de document et y ajouter un fragment de texte ?

R : Dans le didacticiel, vous utilisez leDocument classe pour créer un exemple de document PDF et ajouter un fragment de texte. Ce fragment de texte sert de déclencheur pour afficher le bloc de texte masqué.

Q : Comment puis-je trouver le fragment de texte qui déclenche le bloc de texte masqué ?

R : Le didacticiel montre comment utiliser unTextFragmentAbsorber objet pour trouver le fragment de texte qui déclenche l’affichage du bloc de texte masqué. Il recherche une chaîne de texte spécifique dans le document PDF.

Q : Comment créer et personnaliser le champ de texte masqué ?

R : Vous créez unTextBoxField objet pour représenter le champ de texte masqué. Le didacticiel fournit du code pour définir diverses propriétés telles que la position, la valeur, l’apparence et le comportement du champ de texte masqué.

Q : Comment créer un bouton invisible associé au bloc de texte masqué ?

R : Un champ de bouton invisible est créé à l’aide duButtonField classe. Ce champ de bouton est positionné au-dessus du fragment de texte déclencheur et comporte des actions associées aux événements d’entrée et de sortie de la souris. Ces actions contrôlent la visibilité du bloc de texte masqué.

Q : Puis-je personnaliser l’apparence du bloc de texte masqué et de la zone de déclenchement ?

R : Oui, vous pouvez personnaliser diverses propriétés du champ de texte masqué et du bouton invisible, notamment la police, la couleur, la taille et le positionnement.

Q : Comment puis-je enregistrer le document modifié avec le bloc de texte masqué ?

R : Le didacticiel montre comment enregistrer le document modifié à l’aide duSave méthode duDocument classe.

Obtenez la largeur du texte de manière dynamique Mettre en surbrillance le caractère dans le fichier PDF