Adicionar dica de ferramenta ao texto em arquivo PDF

Este tutorial irá guiá-lo através do processo de adição de dicas de ferramentas ao texto em um arquivo PDF usando Aspose.PDF for .NET. O código-fonte C# fornecido demonstra as etapas necessárias.

Requisitos

Antes de começar, certifique-se de ter o seguinte:

  • Visual Studio ou qualquer outro compilador C# instalado em sua máquina.
  • Biblioteca Aspose.PDF para .NET. Você pode baixá-lo do site oficial do Aspose ou usar um gerenciador de pacotes como o NuGet para instalá-lo.

Etapa 1: configurar o projeto

  1. Crie um novo projeto C# em seu ambiente de desenvolvimento preferido.
  2. Adicione uma referência à biblioteca Aspose.PDF para .NET.

Etapa 2: importar namespaces necessários

No arquivo de código onde você deseja adicionar dicas de ferramentas ao texto, adicione o seguinte usando diretivas na parte superior do arquivo:

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

Etapa 3: definir o diretório do documento

No código, localize a linha que dizstring dataDir = "YOUR DOCUMENT DIRECTORY"; e substitua"YOUR DOCUMENT DIRECTORY" com o caminho para o diretório onde seus documentos estão armazenados.

Etapa 4: crie um documento de amostra com texto

Crie um novoDocument objeto e adicione páginas com fragmentos de texto. No código fornecido, dois fragmentos de texto são adicionados ao documento com o respectivo texto da dica de ferramenta.

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);

Etapa 5: abra o documento e encontre os fragmentos de texto

Carregue o documento criado usando oDocument construtor e encontre os fragmentos de texto que precisam de dicas de ferramentas 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;

Etapa 6: adicione dicas de ferramentas aos fragmentos de texto

Percorra os fragmentos de texto extraídos e crie botões invisíveis em suas posições. Atribua o texto da dica de ferramenta desejado aoAlternateName propriedade doButtonField. Adicione os campos do botão ao formulário do documento.

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

Etapa 7: Repita para fragmentos de texto adicionais com dicas longas

Repita as etapas 5 e 6 para fragmentos de texto com dicas longas. Modifique os critérios de pesquisa e o texto da dica de ferramenta de acordo.

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);
}

Etapa 8: salve o documento modificado

Salve o documento PDF modificado usando oSave método doDocument objeto.

document. Save(outputFile);

Exemplo de código-fonte para adicionar dica de ferramenta ao texto usando Aspose.PDF para .NET

// O caminho para o diretório de documentos.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string outputFile = dataDir + "Tooltip_out.pdf";
// Crie um documento de amostra com 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 com texto
Document document = new Document(outputFile);
// Crie o objeto TextAbsorber para encontrar todas as frases que correspondem à expressão regular
TextFragmentAbsorber absorber = new TextFragmentAbsorber("Move the mouse cursor here to display a tooltip");
// Aceite o absorvedor para as páginas do documento
document.Pages.Accept(absorber);
// Obtenha os fragmentos de texto extraídos
TextFragmentCollection textFragments = absorber.TextFragments;
// Percorrer os fragmentos
foreach (TextFragment fragment in textFragments)
{
	// Crie um botão invisível na posição do fragmento de texto
	ButtonField field = new ButtonField(fragment.Page, fragment.Rectangle);
	// O valor AlternateName será exibido como dica de ferramenta por um aplicativo visualizador
	field.AlternateName = "Tooltip for text.";
	// Adicionar campo de botão ao documento
	document.Form.Add(field);
}
// A seguir, haverá uma amostra de uma dica muito longa
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);
	// Defina um texto muito longo
	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);
}
// Salvar documento
document.Save(outputFile);

Conclusão

Você adicionou com sucesso dicas de ferramentas ao texto em um documento PDF usando Aspose.PDF for .NET. O arquivo PDF resultante agora pode ser encontrado no caminho do arquivo de saída especificado.

Perguntas frequentes

P: Qual é o foco deste tutorial?

R: Este tutorial se concentra na adição de dicas de ferramentas ao texto em um arquivo PDF usando a biblioteca Aspose.PDF for .NET. O código-fonte C# fornecido demonstra as etapas necessárias para conseguir isso.

P: Quais namespaces precisam ser importados para este tutorial?

R: No arquivo de código onde você deseja adicionar dicas de ferramentas ao texto, importe os seguintes namespaces no início do arquivo:

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

P: Como especifico o diretório do documento?

R: No código, encontre a linhastring dataDir = "YOUR DOCUMENT DIRECTORY"; e substitua"YOUR DOCUMENT DIRECTORY" com o caminho real para o diretório do seu documento.

P: Como posso criar um documento de amostra com texto?

R: Na Etapa 4, você criará um novoDocument objeto e adicione páginas com fragmentos de texto. O código fornecido adiciona dois fragmentos de texto com o respectivo texto da dica de ferramenta.

P: Como abro o documento e encontro os fragmentos de texto?

R: Na Etapa 5, você carregará o documento criado usando oDocument construtor e encontre os fragmentos de texto que requerem dicas de ferramentas usando oTextFragmentAbsorber.

P: Como adiciono dicas de ferramentas aos fragmentos de texto?

R: Na Etapa 6, você percorrerá os fragmentos de texto extraídos e criará botões invisíveis em suas posições. O texto da dica de ferramenta é atribuído aoAlternateName propriedade doButtonFieldque é adicionado ao formulário do documento.

P: Como repito o processo para fragmentos de texto adicionais com dicas de ferramentas longas?

R: Para fragmentos de texto com dicas de ferramentas longas, repita as etapas 5 e 6. Modifique os critérios de pesquisa e o texto da dica de ferramenta de acordo.

P: Como salvo o documento modificado?

R: Na Etapa 8, você salvará o documento PDF modificado usando oSave método doDocument objeto.

P: Qual é a principal conclusão deste tutorial?

R: Seguindo este tutorial, você aprendeu como aprimorar seu documento PDF adicionando dicas de ferramentas ao texto usando Aspose.PDF for .NET. Isso pode fornecer informações adicionais valiosas para os leitores quando eles interagem com o conteúdo do PDF.

Adicionar texto com cores de sombreamento em arquivo PDF Adicionar texto transparente em arquivo PDF