Agregar información sobre herramientas al texto en un archivo PDF

Este tutorial lo guiará a través del proceso de agregar información sobre herramientas al texto en un archivo PDF usando Aspose.PDF para .NET. El código fuente de C# proporcionado demuestra los pasos necesarios.

Requisitos

Antes de comenzar, asegúrese de tener lo siguiente:

  • Visual Studio o cualquier otro compilador de C# instalado en su máquina.
  • Aspose.PDF para la biblioteca .NET. Puede descargarlo del sitio web oficial de Aspose o utilizar un administrador de paquetes como NuGet para instalarlo.

Paso 1: configurar el proyecto

  1. Cree un nuevo proyecto de C# en su entorno de desarrollo preferido.
  2. Agregue una referencia a la biblioteca Aspose.PDF para .NET.

Paso 2: importar los espacios de nombres necesarios

En el archivo de código donde desea agregar información sobre herramientas al texto, agregue lo siguiente usando directivas en la parte superior del archivo:

using Aspose.Pdf;
using Aspose.Pdf.Forms;
using Aspose.Pdf.Text;

Paso 3: configurar el directorio de documentos

En el código, localice la línea que dicestring dataDir = "YOUR DOCUMENT DIRECTORY"; y reemplazar"YOUR DOCUMENT DIRECTORY" con la ruta al directorio donde están almacenados sus documentos.

Paso 4: crea un documento de muestra con texto

Crear un nuevoDocument objeto y agregar páginas con fragmentos de texto. En el código proporcionado, se agregan dos fragmentos de texto al documento con el texto de información sobre herramientas respectivo.

Document doc = new Document();
doc.Pages.Add().Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a tooltip"));
doc.Pages[1].Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a very long tooltip"));
doc.Save(outputFile);

Paso 5: abre el documento y busca los fragmentos de texto.

Cargue el documento creado usando elDocument constructor y encuentre los fragmentos de texto que necesitan información sobre herramientas usandoTextFragmentAbsorber.

Document document = new Document(outputFile);
TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a tooltip");
document.Pages.Accept(absorb);
TextFragmentCollection textFragments = absorb.TextFragments;

Paso 6: agregue información sobre herramientas a los fragmentos de texto

Recorra los fragmentos de texto extraídos y cree botones invisibles en sus posiciones. Asigne el texto de información sobre herramientas deseado alAlternateName propiedad de laButtonField. Agregue los campos del botón al formulario del documento.

foreach(TextFragment fragment in textFragments)
{
     ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
     field. AlternateName = "Tooltip for text.";
     document.Form.Add(field);
}

Paso 7: repita para obtener fragmentos de texto adicionales con información sobre herramientas larga

Repita los pasos 5 y 6 para fragmentos de texto con información sobre herramientas larga. Modifique los criterios de búsqueda y el texto de información sobre herramientas en consecuencia.

absorb = new TextFragmentAbsorber("Move the mouse cursor here to display a very long tooltip");
document.Pages.Accept(absorb);
textFragments = absorb.TextFragments;

foreach(TextFragment fragment in textFragments)
{
     ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
     field. AlternateName = "Long tooltip text goes here...";
     document.Form.Add(field);
}

Paso 8: guarde el documento modificado

Guarde el documento PDF modificado utilizando elSave método de laDocument objeto.

document. Save(outputFile);

Código fuente de muestra para Agregar información sobre herramientas al texto usando Aspose.PDF para .NET

// La ruta al directorio de documentos.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string outputFile = dataDir + "Tooltip_out.pdf";
// Crear documento de muestra con texto
Document doc = new Document();
doc.Pages.Add().Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a tooltip"));
doc.Pages[1].Paragraphs.Add(new TextFragment("Move the mouse cursor here to display a very long tooltip"));
doc.Save(outputFile);
// Abrir documento con texto
Document document = new Document(outputFile);
// Cree un objeto TextAbsorber para encontrar todas las frases que coincidan con la expresión regular
TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a tooltip");
// Aceptar el absorbente para las páginas del documento.
document.Pages.Accept(absorber);
// Obtenga los fragmentos de texto extraídos
TextFragmentCollection textFragments = absorber.TextFragments;
// Recorre los fragmentos
foreach (TextFragment fragment in textFragments)
{
	// Crear botón invisible en la posición del fragmento de texto
	ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
	// El valor de Nombre alternativo se mostrará como información sobre herramientas en una aplicación de visualización
	field.AlternateName = "Tooltip for text.";
	// Agregar campo de botón al documento
	document.Form.Add(field);
}
// Lo siguiente será una muestra de información sobre herramientas muy larga.
absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a very long tooltip");
document.Pages.Accept(absorber);
textFragments = absorber.TextFragments;
foreach (TextFragment fragment in textFragments)
{
	ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
	// Establecer texto muy largo
	field.AlternateName = "Lorem ipsum dolor sit amet, consectetur adipiscing elit," +
							" sed do eiusmod tempor incididunt ut labore et dolore magna" +
							" aliqua. Ut enim ad minim veniam, quis nostrud exercitation" +
							" ullamco laboris nisi ut aliquip ex ea commodo consequat." +
							" Duis aute irure dolor in reprehenderit in voluptate velit" +
							" esse cillum dolore eu fugiat nulla pariatur. Excepteur sint" +
							" occaecat cupidatat non proident, sunt in culpa qui officia" +
							" deserunt mollit anim id est laborum.";
	document.Form.Add(field);
}
// guardar documento
document.Save(outputFile);

Conclusión

Ha agregado correctamente información sobre herramientas al texto de un documento PDF utilizando Aspose.PDF para .NET. El archivo PDF resultante ahora se puede encontrar en la ruta del archivo de salida especificada.

Preguntas frecuentes

P: ¿Cuál es el enfoque de este tutorial?

R: Este tutorial se centra en agregar información sobre herramientas al texto dentro de un archivo PDF utilizando la biblioteca Aspose.PDF para .NET. El código fuente de C# proporcionado demuestra los pasos necesarios para lograrlo.

P: ¿Qué espacios de nombres se deben importar para este tutorial?

R: En el archivo de código donde desea agregar información sobre herramientas al texto, importe los siguientes espacios de nombres al principio del archivo:

using Aspose.Pdf;
using Aspose.Pdf.Forms;
using Aspose.Pdf.Text;

P: ¿Cómo especifico el directorio de documentos?

R: En el código, busque la líneastring dataDir = "YOUR DOCUMENT DIRECTORY"; y reemplazar"YOUR DOCUMENT DIRECTORY" con la ruta real a su directorio de documentos.

P: ¿Cómo puedo crear un documento de muestra con texto?

R: En el paso 4, creará un nuevoDocument objeto y agregar páginas con fragmentos de texto. El código proporcionado agrega dos fragmentos de texto con el texto de información sobre herramientas respectivo.

P: ¿Cómo abro el documento y encuentro los fragmentos de texto?

R: En el Paso 5, cargará el documento creado usando elDocument constructor y encuentre los fragmentos de texto que requieren información sobre herramientas utilizando elTextFragmentAbsorber.

P: ¿Cómo agrego información sobre herramientas a los fragmentos de texto?

R: En el paso 6, recorrerá los fragmentos de texto extraídos y creará botones invisibles en sus posiciones. El texto de información sobre herramientas se asigna alAlternateName propiedad de laButtonFieldque se agrega al formulario del documento.

P: ¿Cómo repito el proceso para fragmentos de texto adicionales con información sobre herramientas larga?

R: Para fragmentos de texto con información sobre herramientas larga, repita los pasos 5 y 6. Modifique los criterios de búsqueda y el texto de información sobre herramientas en consecuencia.

P: ¿Cómo guardo el documento modificado?

R: En el paso 8, guardará el documento PDF modificado usando elSave método de laDocument objeto.

P: ¿Cuál es la principal conclusión de este tutorial?

R: Al seguir este tutorial, habrá aprendido cómo mejorar su documento PDF agregando información sobre herramientas al texto usando Aspose.PDF para .NET. Esto puede proporcionar información adicional valiosa para los lectores cuando interactúan con el contenido del PDF.

Agregar texto con colores de sombreado en un archivo PDF Agregar texto transparente en un archivo PDF