Marcar imagem em PDF existente

Neste tutorial detalhado, orientaremos você passo a passo pelo código-fonte C# fornecido para marcar uma imagem em um PDF existente usando Aspose.PDF for .NET. Siga as instruções abaixo para entender como adicionar tags a uma imagem em um PDF.

Passo 1: Configurando o ambiente

Antes de começar, certifique-se de ter configurado seu ambiente de desenvolvimento para usar Aspose.PDF for .NET. Isso inclui a instalação da biblioteca Aspose.PDF e a configuração do seu projeto para referenciá-la.

Passo 2: Abra o documento PDF existente

Nesta etapa, abriremos um documento PDF existente usando Aspose.PDF.

// O caminho para o diretório de documentos.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

// Caminhos de arquivo de entrada e saída
string inFile = dataDir + "TH.pdf";
string outFile = dataDir + "TH_out.pdf";
string logFile = dataDir + "TH_out.xml";

// Abra o documento
Document document = new Document(inFile);

Abrimos o documento PDF existente usando Aspose.PDF.

Etapa 3: Obtenha o conteúdo marcado e o elemento da estrutura raiz

Agora obteremos o conteúdo marcado do documento PDF e o elemento da estrutura raiz correspondente.

// Obtenha conteúdo marcado e elemento de estrutura raiz
ITaggedContent taggedContent = document.TaggedContent;
StructureElement rootElement = taggedContent.RootElement;

Obtivemos o conteúdo marcado do documento PDF e o elemento da estrutura raiz correspondente.

Passo 4: Definir o título do documento PDF marcado

Agora vamos definir o título do documento PDF marcado.

// Defina o título do documento PDF marcado
taggedContent.SetTitle("Document with images");

Definimos o título do documento PDF marcado.

Etapa 5: atribua textos alternativos e caixa delimitadora à imagem

Agora, para cada elemento da imagem, atribuiremos um texto alternativo e uma caixa delimitadora.

foreach(FigureElement figureElement in rootElement.FindElements<FigureElement>(true))
{
     // Atribuir texto alternativo à imagem
     figureElement.AlternativeText = "Alternative text for image (technique 2)";
     // Crie e atribua a caixa delimitadora (bbox)
     StructureAttribute bboxAttribute = new StructureAttribute(AttributeKey.BBox);
     bboxAttribute.SetRectangleValue(new Rectangle(0.0, 0.0, 100.0, 100.0));
     StructureAttributes figureLayoutAttributes = figureElement.Attributes.GetAttributes(AttributeOwnerStandard.Layout);
     figureLayoutAttributes.SetAttribute(bboxAttribute);
}

Atribuímos texto alternativo e uma caixa delimitadora a cada elemento de imagem no documento PDF.

Etapa 6: mover o elemento Span para o parágrafo

Agora vamos mover o elemento Span para dentro do parágrafo.

// Mova o elemento Span para o parágrafo (encontre span e parágrafo incorretos no primeiro TD)
TableElement tableElement = rootElement.FindElements<TableElement>(true)[0];
SpanElement spanElement = tableElement.FindElements<SpanElement>(true)[0];
TableTDElement firstTdElement = tableElement.FindElements<TableTDElement>(true)[0];
ParagraphElement paragraph = firstTdElement.FindElements<ParagraphElement>(true)[0];

// Mova o elemento Span no parágrafo
spanElement.ChangeParentElement(paragraph);

Movemos o elemento Span para o parágrafo especificado.

Passo 7: Salvando o documento PDF modificado

Agora que fizemos as alterações necessárias, salvaremos o documento PDF modificado.

// Salve o documento PDF
document. Save(outFile);

Salvamos o documento PDF modificado no diretório especificado.

Exemplo de código-fonte para etiquetar imagem em PDF existente usando Aspose.PDF para .NET


// O caminho para o diretório de documentos.
string dataDir = "YOUR DOCUMENT DIRECTORY";
string inFile = dataDir + "TH.pdf";
string outFile = dataDir + "TH_out.pdf";
string logFile = dataDir + "TH_out.xml";

// Abrir documento
Document document = new Document(inFile);

// Obtém conteúdo marcado e elemento de estrutura raiz
ITaggedContent taggedContent = document.TaggedContent;
StructureElement rootElement = taggedContent.RootElement;

// Definir título para documento PDF marcado
taggedContent.SetTitle("Document with images");
foreach (FigureElement figureElement in rootElement.FindElements<FigureElement>(true))
{
	// Definir texto alternativo para figura
	figureElement.AlternativeText = "Figure alternative text (technique 2)";
	// Criar e definir atributos BBox
	StructureAttribute bboxAttribute = new StructureAttribute(AttributeKey.BBox);
	bboxAttribute.SetRectangleValue(new Rectangle(0.0, 0.0, 100.0, 100.0));
	StructureAttributes figureLayoutAttributes = figureElement.Attributes.GetAttributes(AttributeOwnerStandard.Layout);
	figureLayoutAttributes.SetAttribute(bboxAttribute);
}

// Mova o elemento Span para o parágrafo (encontre o span e o parágrafo errados no primeiro TD)
TableElement tableElement = rootElement.FindElements<TableElement>(true)[0];
SpanElement spanElement = tableElement.FindElements<SpanElement>(true)[0];
TableTDElement firstTdElement = tableElement.FindElements<TableTDElement>(true)[0];
ParagraphElement paragraph = firstTdElement.FindElements<ParagraphElement>(true)[0];

// Mover o elemento Span para o parágrafo
spanElement.ChangeParentElement(paragraph);

// Salvar documento
document.Save(outFile);

//Verificando a conformidade com PDF/UA para nosso documento
document = new Document(outFile);
bool isPdfUaCompliance = document.Validate(logFile, PdfFormat.PDF_UA_1);
Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));

Conclusão

Neste tutorial, aprendemos como marcar uma imagem em um PDF existente usando Aspose.PDF for .NET. Agora você pode usar Aspose.PDF para adicionar tags e fazer edições em imagens em seus documentos PDF.

Perguntas frequentes

P: Qual é o objetivo principal deste tutorial sobre marcação de imagens em um PDF existente usando Aspose.PDF for .NET?

R: O objetivo principal deste tutorial é guiá-lo através do processo de marcação de uma imagem em um documento PDF existente usando Aspose.PDF for .NET. O tutorial fornece instruções passo a passo e exemplos de código-fonte C# para ajudar você a entender como atribuir texto alternativo e caixas delimitadoras a imagens, mover elementos dentro do documento e adicionar tags a imagens.

P: Quais são os pré-requisitos para seguir este tutorial sobre como marcar imagens em um PDF usando Aspose.PDF for .NET?

R: Antes de começar, certifique-se de ter configurado seu ambiente de desenvolvimento para usar Aspose.PDF for .NET. Isso envolve a instalação da biblioteca Aspose.PDF e a configuração do seu projeto para referenciá-la.

P: Como posso abrir um documento PDF existente e acessar seu conteúdo marcado usando Aspose.PDF for .NET?

R: O tutorial fornece exemplos de código-fonte C# que demonstram como abrir um documento PDF existente usando Aspose.PDF for .NET e acessar seu conteúdo marcado para manipulação adicional.

P: Qual é o propósito de atribuir texto alternativo e caixas delimitadoras a imagens em um documento PDF?

R: Atribuir texto alternativo e caixas delimitadoras às imagens melhora a acessibilidade, fornecendo texto descritivo para imagens e definindo seu layout e posição no documento. Esta informação é crucial para leitores de tela e outras tecnologias assistivas.

P: Como posso definir o título de um documento PDF marcado usando Aspose.PDF for .NET?

R: O tutorial inclui exemplos de código-fonte C# que ilustram como definir o título de um documento PDF marcado usando Aspose.PDF para .NET.

P: O que envolve o processo de movimentação de elementos em um documento PDF?

R: Mover elementos em um documento PDF envolve alterar o elemento pai de um elemento específico. Neste tutorial, você aprenderá como mover um elemento Span para um elemento Paragraph especificado em uma tabela.

P: Como salvo o documento PDF modificado após adicionar tags e fazer edições nas imagens?

R: Depois de adicionar tags, atribuir texto alternativo, definir caixas delimitadoras e fazer edições no documento PDF, você poderá usar os exemplos de código-fonte C# fornecidos para salvar o documento PDF modificado usando o métodoSave() método.

P: Qual é a finalidade do exemplo de código-fonte fornecido no tutorial?

R: O código-fonte de amostra serve como referência prática para implementar marcação e manipulação de imagens usando Aspose.PDF para .NET. Você pode usar este código como ponto de partida e modificá-lo para atender às suas necessidades específicas.

P: Posso aplicar essas técnicas a outros tipos de elementos em um documento PDF, não apenas a imagens?

R: Sim, as técnicas demonstradas neste tutorial podem ser adaptadas para trabalhar com vários tipos de elementos dentro de um documento PDF. Você pode aplicar princípios semelhantes para marcar e manipular outros elementos, como texto, tabelas e muito mais.

P: Como posso validar a conformidade com PDF/UA do documento PDF modificado?

R: O tutorial fornece exemplos de código-fonte C# que mostram como validar a conformidade com PDF/UA do documento PDF modificado usando o métodoValidate() método e gerando um relatório XML.

P: Que outros recursos o Aspose.PDF for .NET oferece para trabalhar com documentos PDF?

R: Aspose.PDF for .NET oferece uma ampla gama de recursos para trabalhar com documentos PDF, incluindo manipulação de texto, inserção de imagens, criação de tabelas, gerenciamento de campos de formulário, assinaturas digitais, anotações e muito mais. Consulte a documentação e os recursos oficiais para uma exploração mais aprofundada.

Conteúdo PDF marcado Elementos da estrutura do bloco de texto