Os marcadores facilitam a navegação em documentos grandes. Os leitores podem facilmente pular entre diferentes páginas e seções, em vez de rolar por todo o documento. A API Aspose.PDF Cloud oferece muitos recursos de manipulação de PDF. Trabalhar com marcadores é um dos recursos comumente usados da API. Neste blog, aprenderemos os seguintes casos de uso:
- Adicionar marcadores em documentos PDF
- Excluir marcadores em documento PDF
- Atualizar favoritos em documento PDF
Aspose.PDF Cloud A API suporta muitas linguagens de programação, incluindo C#, Java, Python, Go, Ruby, PHP e muitas outras. Os respectivos SDKs estão disponíveis para sua conveniência. Você pode simplesmente integrar qualquer um dos SDKs em seus aplicativos, pois o SDK cuidará de pequenos detalhes relacionados a solicitações e respostas. Isso permite que você se concentre nos principais recursos que deseja incluir em seu aplicativo. Vamos prosseguir para os recursos relacionados aos favoritos em aplicativos .NET:
Adicionar marcadores em documento PDF
Às vezes, adicionar marcadores é um critério necessário ao enviar documentos, por exemplo, processos legais. Em tais cenários, seus aplicativos podem ser suficientes para atender a todas as suas necessidades. Você simplesmente precisa especificar os atributos ou propriedades do marcador e enviar a solicitação para inserir o marcador no arquivo PDF. O código C# abaixo é uma demonstração do uso desse recurso:
// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Pdf-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "2";
var bookmark = new Bookmark();
bookmark.Action = "GoTo";
bookmark.Bold = true;
bookmark.Italic = false;
bookmark.Title = "New Bookmark XYZ";
bookmark.PageDisplay = "XYZ";
bookmark.PageDisplayBottom = 10;
bookmark.PageDisplayLeft = 10;
bookmark.PageDisplayRight = 10;
bookmark.PageDisplayTop = 10;
bookmark.PageDisplayZoom = 2;
bookmark.PageNumber = 2;
bookmark.Color = new Color(255, 255, 0, 0);
var bookmarks = new List<Bookmark>();
bookmarks.Add(bookmark);
var response = pdfApi.PostBookmark(name, bookmarkPath, bookmarks, folder: TempFolder);
Aqui, quase todos os atributos da classe Bookmark são autoexplicativos. No entanto, o parâmetro bookmarkPath aponta para o marcador pai na árvore. Se você quiser adicionar um marcador à raiz, você deve especificar uma string vazia como o caminho. A seguir está uma captura de tela do documento PDF de saída com um marcador adicionado pelo trecho de código acima.
Excluir marcador em documento PDF
É importante notar aqui que excluir um marcador pai excluirá todos os marcadores filhos também. No entanto, excluir um marcador não exclui nenhum texto ou parte do documento. Vamos aprender isso com um exemplo na linguagem C#:
// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Pdf-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "1/1";
var response = pdfApi.DeleteBookmark(name, bookmarkPath, folder: TempFolder);
Você pode notar que precisamos simplesmente especificar a propriedade bookmarkPath, conforme explicado acima, antes de chamar a API.
Atualizar marcadores em documento PDF
Talvez seja necessário atualizar marcadores em documentos PDF renomeando um marcador, atualizando o destino ou a aparência. A API é avançada o suficiente para suportar esses recursos também. O snippet de código abaixo pode ser usado para atualizar marcadores:
// Obtenha AppKey e AppSID de https://dashboard.aspose.cloud/
// Instalar pacote Nuget Aspose.Pdf-Cloud
// Para exemplos completos e arquivos de dados, acesse https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "1/1";
var bookmark = new Bookmark();
bookmark.Action = "GoTo";
bookmark.Bold = true;
bookmark.Italic = false;
bookmark.Title = "Updated Bookmark XYZ";
bookmark.PageDisplay = "XYZ";
bookmark.PageDisplayBottom = 10;
bookmark.PageDisplayLeft = 10;
bookmark.PageDisplayRight = 10;
bookmark.PageDisplayTop = 10;
bookmark.PageDisplayZoom = 2;
bookmark.PageNumber = 2;
bookmark.Color = new Color(255, 255, 0, 0);
var response = PdfApi.PutBookmark(name, bookmarkPath, bookmark, folder: TempFolder);
Curioso sobre outros recursos oferecidos pela API? Você pode explorar algumas das possibilidades em Documentação da API. Se quiser testar a API em sua capacidade total, então Inscreva-se gratuitamente e use a API com o generoso teste gratuito. Se tiver alguma dúvida, sinta-se à vontade para entrar em contato conosco por meio dos Fóruns de suporte gratuito.
Postagem relacionada
Recomendamos visitar os seguintes links para saber mais sobre: