Los marcadores facilitan la navegación en documentos grandes. Los lectores pueden saltar fácilmente entre distintas páginas y secciones, en lugar de tener que desplazarse por todo el documento. Aspose.PDF Cloud API ofrece muchas funciones de manipulación de PDF. Trabajar con marcadores es una de las funciones más utilizadas de la API. En este blog, aprenderemos los siguientes casos de uso:
- Agregar marcadores en documentos PDF
- Eliminar marcadores en un documento PDF
- Actualizar marcadores en un documento PDF
Aspose.PDF Cloud La API admite muchos lenguajes de programación, incluidos C#, Java, Python, Go, Ruby, PHP y muchos más. Los SDK correspondientes están disponibles para su comodidad. Puede integrar cualquiera de los SDK en sus aplicaciones, ya que el SDK se ocupará de los detalles menores relacionados con las solicitudes y respuestas. Esto le permite centrarse en las características principales que desea incluir en su aplicación. Pasemos a las características relacionadas con los marcadores en las aplicaciones .NET:
Agregar marcadores en un documento PDF
A veces, agregar marcadores es un criterio necesario al enviar documentos, por ejemplo, presentaciones legales. En tales casos, sus aplicaciones pueden ser suficientes para satisfacer todas sus necesidades. Solo necesita especificar los atributos o propiedades del marcador y enviar la solicitud para insertar el marcador en el archivo PDF. A continuación, se muestra un código C# que demuestra cómo usar esta función:
// Obtenga AppKey y AppSID desde https://dashboard.aspose.cloud/
// Instalar el paquete Nuget Aspose.Pdf-Cloud
// Para obtener ejemplos completos y archivos de datos, visite 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);
Aquí casi todos los atributos de la clase Bookmark se explican por sí solos. Sin embargo, el parámetro bookmarkPath apunta al marcador principal en el árbol. Si desea agregar un marcador a la raíz, debe especificar una cadena vacía como ruta. A continuación, se muestra una captura de pantalla del documento PDF de salida con un marcador agregado por el fragmento de código anterior.
Eliminar marcador en documento PDF
Es importante tener en cuenta que al eliminar un marcador principal, también se eliminarán todos sus marcadores secundarios. Sin embargo, al eliminar un marcador no se elimina ningún texto ni ninguna parte del documento. Aprendamos esto con un ejemplo en lenguaje C#:
// Obtenga AppKey y AppSID desde https://dashboard.aspose.cloud/
// Instalar el paquete Nuget Aspose.Pdf-Cloud
// Para obtener ejemplos completos y archivos de datos, visite 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);
Puedes observar que simplemente necesitamos especificar la propiedad bookmarkPath, como se explicó anteriormente, antes de llamar a la API.
Actualizar marcadores en un documento PDF
Es posible que necesites actualizar los marcadores en documentos PDF cambiando el nombre de un marcador, actualizando el destino o la apariencia. La API es lo suficientemente avanzada como para admitir también estas funciones. El siguiente fragmento de código se puede utilizar para actualizar los marcadores:
// Obtenga AppKey y AppSID desde https://dashboard.aspose.cloud/
// Instalar el paquete Nuget Aspose.Pdf-Cloud
// Para obtener ejemplos completos y archivos de datos, visite 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);
¿Tienes curiosidad por conocer otras funciones que ofrece la API? Puedes explorar algunas de las posibilidades en la Documentación de la API. Si quieres probar la API en toda su capacidad, Regístrate de forma gratuita y usa la API con la generosa prueba gratuita. Si tienes alguna pregunta, no dudes en ponerte en contacto con nosotros a través de los Foros de soporte gratuitos.
Publicación relacionada
Le recomendamos visitar los siguientes enlaces para obtener más información sobre: