Pesquisar texto e adicionar hiperlink

Este tutorial explica como usar Aspose.PDF for .NET para pesquisar texto específico em um documento PDF, adicionar um hiperlink ao texto encontrado e salvar o documento modificado. O código-fonte C# fornecido demonstra o processo passo a passo.

Pré-requisitos

Antes de prosseguir com o tutorial, certifique-se de ter o seguinte:

Conhecimento básico da linguagem de programação C#.
Biblioteca Aspose.PDF para .NET instalada. Você pode obtê-lo no site Aspose ou usar o NuGet para instalá-lo em seu projeto.

Etapa 1: configurar o projeto

Comece criando um novo projeto C# em seu ambiente de desenvolvimento integrado (IDE) preferido e adicione uma referência à biblioteca Aspose.PDF para .NET.

Etapa 2: importe os namespaces necessários

Adicione as seguintes diretivas using no início do arquivo C# para importar os namespaces necessários:

using Aspose.Pdf;
using Aspose.Pdf.Content;
using Aspose.Pdf.Facades;
using Aspose.Pdf.Text;

Etapa 3: Defina o caminho para o diretório do documento

Defina o caminho para o diretório do seu documento usando odataDir variável:

string dataDir = "YOUR DOCUMENT DIRECTORY";

Substituir"YOUR DOCUMENT DIRECTORY" com o caminho real para o diretório do seu documento.

Etapa 4: crie um TextFragmentAbsorber

Criar umaTextFragmentAbsorber objeto para localizar todas as instâncias da frase de pesquisa de entrada:

TextFragmentAbsorber absorber = new TextFragmentAbsorber("\\d{4}-\\d{4}");

Substituir"\\d{4}-\\d{4}" com o padrão de expressão regular desejado.

Etapa 5: ativar a pesquisa de expressões regulares

Habilite a pesquisa de expressões regulares definindo oTextSearchOptions propriedade do absorvedor:

absorber.TextSearchOptions = new TextSearchOptions(true);

Passo 6: Abra e vincule o documento PDF

Criar umaPdfContentEditor objeto e vincule-o ao arquivo PDF de origem:

PdfContentEditor editor = new PdfContentEditor();
editor.BindPdf(dataDir + "SearchRegularExpressionPage.pdf");

Substituir"SearchRegularExpressionPage.pdf" com o nome real do seu arquivo PDF.

Etapa 7: escolha o absorvente para a página

Aceite o absorvente para a página desejada do documento:

editor.Document.Pages[1].Accept(absorber);

Substituir1 com o número da página desejada.

Etapa 8: adicione hiperlinks ao texto encontrado

Percorra os fragmentos de texto recuperados e adicione hiperlinks a eles:

foreach (TextFragment textFragment in absorber.TextFragments)
{
    textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Blue;
    // Crie um retângulo com base na posição do fragmento de texto
    System.Drawing.Rectangle rect = new System.Drawing.Rectangle((int)textFragment.Rectangle.LLX,
        (int)Math.Round(textFragment.Rectangle.LLY), (int)Math.Round(textFragment.Rectangle.Width + 2),
        (int)Math.Round(textFragment.Rectangle.Height + 1));
    //Adicione um link da web ao retângulo
    editor.CreateWebLink(rect, "http://www.aspose.com", 1, System.Drawing.Color.Blue);
}

Substituir"http://www.aspose.com" com o URL do hiperlink desejado.

Etapa 9: salve e feche o documento modificado

Salve o documento modificado e feche o editor:

dataDir = dataDir + "SearchTextAndAddHyperlink_out.pdf";
editor.Save(dataDir);
editor.Close();
Console.WriteLine("\nText replaced and hyperlink added successfully based on a regular expression.\nFile saved at " + dataDir);

Certifique-se de substituir"SearchTextAndAddHyperlink_out.pdf" com o nome do arquivo de saída desejado.

Exemplo de código-fonte para pesquisar texto e adicionar hiperlink usando Aspose.PDF para .NET

// O caminho para o diretório de documentos.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// Crie um objeto absorvedor para encontrar todas as instâncias da frase de pesquisa de entrada
TextFragmentAbsorber absorber = new TextFragmentAbsorber("\\d{4}-\\d{4}");
// Ativar pesquisa por expressão regular
absorber.TextSearchOptions = new TextSearchOptions(true);
// Abrir documento
PdfContentEditor editor = new PdfContentEditor();
// Vincular arquivo PDF de origem
editor.BindPdf(dataDir + "SearchRegularExpressionPage.pdf");
// Escolha o absorvente para a página
editor.Document.Pages[1].Accept(absorber);
int[] dashArray = { };
String[] LEArray = { };
System.Drawing.Color blue = System.Drawing.Color.Blue;
// Percorrer os fragmentos
foreach (TextFragment textFragment in absorber.TextFragments)
{
	textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Blue;
	System.Drawing.Rectangle rect = new System.Drawing.Rectangle((int)textFragment.Rectangle.LLX,
		(int)Math.Round(textFragment.Rectangle.LLY), (int)Math.Round(textFragment.Rectangle.Width + 2),
		(int)Math.Round(textFragment.Rectangle.Height + 1));
	Enum[] actionName = new Enum[2] { Aspose.Pdf.Annotations.PredefinedAction.Document_AttachFile, Aspose.Pdf.Annotations.PredefinedAction.Document_ExtractPages };
	editor.CreateWebLink(rect, "http:// www.aspose.com", 1, azul, actionName);
	editor.CreateLine(rect, "", (float)textFragment.Rectangle.LLX + 1, (float)textFragment.Rectangle.LLY - 1,
		(float)textFragment.Rectangle.URX, (float)textFragment.Rectangle.LLY - 1, 1, 1, blue, "S", dashArray, LEArray);
}
dataDir = dataDir + "SearchTextAndAddHyperlink_out.pdf";
editor.Save(dataDir);
editor.Close();
Console.WriteLine("\nText replaced and hyperlink added successfully based on a regular expression.\nFile saved at " + dataDir);

Conclusão

Parabéns! Você aprendeu com sucesso como pesquisar um texto específico em um documento PDF, adicionar hiperlinks ao texto encontrado e salvar o documento modificado usando Aspose.PDF para .NET. Este tutorial forneceu um guia passo a passo, desde a configuração do projeto até a execução das ações necessárias. Agora você pode incorporar esse código em seus próprios projetos C# para manipular texto e adicionar hiperlinks em arquivos PDF.

Perguntas frequentes

P: Qual é o objetivo do tutorial “Pesquisar texto e adicionar hiperlink”?

R: O tutorial “Pesquisar texto e adicionar hiperlink” tem como objetivo demonstrar como usar a biblioteca Aspose.PDF para .NET para pesquisar texto específico em um documento PDF, adicionar hiperlinks ao texto encontrado e salvar o documento modificado. O tutorial fornece um guia abrangente e exemplos de código C# para ilustrar o processo passo a passo.

P: Como este tutorial ajuda a adicionar hiperlinks a textos específicos em um documento PDF?

R: Este tutorial orienta você no processo de uso da biblioteca Aspose.PDF para localizar texto específico em um documento PDF, aplicar um hiperlink ao texto identificado e salvar o PDF modificado. Abrange etapas essenciais, como configurar o projeto, carregar o documento, ativar a pesquisa de expressões regulares e adicionar hiperlinks ao texto encontrado.

P: Quais pré-requisitos são necessários para seguir este tutorial?

R: Antes de começar, você deve ter um conhecimento básico da linguagem de programação C#. Além disso, você precisa ter a biblioteca Aspose.PDF for .NET instalada, que pode ser obtida no site Aspose ou instalada usando NuGet em seu projeto.

P: Como configuro meu projeto para seguir este tutorial?

R: Comece criando um novo projeto C# em seu ambiente de desenvolvimento integrado (IDE) preferido. Em seguida, adicione uma referência à biblioteca Aspose.PDF for .NET, que permitirá utilizar os recursos da biblioteca em seu projeto.

P: Posso adicionar hiperlinks a textos específicos usando este tutorial?

R: Sim, este tutorial concentra-se especificamente na adição de hiperlinks a textos específicos em um documento PDF. Ele demonstra como localizar e extrair o texto desejado usando expressões regulares, criar hiperlinks associados aos fragmentos de texto e salvar o PDF modificado.

P: Como defino o texto que desejo pesquisar e ao qual adiciono um hiperlink?

R: Para especificar o texto que você deseja pesquisar e ao qual adicionar um hiperlink, crie umTextFragmentAbsorber objeto e definir seu padrão usando oText parâmetro. Substitua o padrão padrão"\\d{4}-\\d{4}" no código do tutorial com o padrão de expressão regular desejado.

P: Como posso ativar a pesquisa de expressões regulares para texto?

R: A pesquisa de expressões regulares é habilitada criando umTextSearchOptions objeto e definindo seu valor comotrue . Atribuir este objeto aoTextSearchOptions propriedade doTextFragmentAbsorber instância. Isso garante que o padrão de expressão regular seja aplicado durante a pesquisa de texto.

P: Como adiciono hiperlinks ao texto encontrado?

R: Depois de identificar os fragmentos de texto usando oTextFragmentAbsorber , o tutorial fornece um loop para iterar por esses fragmentos. Para cada fragmento de texto, o tutorial demonstra como definir a cor do texto para azul e criar um hiperlink usando oCreateWebLink método.

P: Quais são as etapas para salvar o PDF modificado com hiperlinks?

R: Depois de adicionar hiperlinks aos fragmentos de texto desejados, use oPdfContentEditor class para salvar o documento modificado. O código de exemplo do tutorial mostra como salvar o PDF editado, fechar o editor e exibir uma mensagem de sucesso.

Pesquisar expressão regular em arquivo PDF Pesquise texto e desenhe retângulo