Les signets facilitent la navigation dans les documents volumineux. Les lecteurs peuvent facilement passer d’une page ou d’une section à l’autre, au lieu de faire défiler l’ensemble du document. L’API Cloud Aspose.PDF offre de nombreuses fonctionnalités de manipulation de PDF. L’utilisation des signets est l’une des fonctionnalités les plus couramment utilisées de l’API. Dans ce blog, nous allons découvrir les cas d’utilisation suivants :
- Ajouter des signets dans les documents PDF
- Supprimer les signets dans un document PDF
- Mettre à jour les signets dans le document PDF
Aspose.PDF Cloud API prend en charge de nombreux langages de programmation, notamment C#, Java, Python, Go, Ruby, PHP et bien d’autres. Des SDK respectifs sont disponibles pour votre commodité. Vous pouvez simplement intégrer l’un des SDK dans vos applications, car le SDK s’occupera des détails mineurs liés aux requêtes et aux réponses. Cela vous permet de vous concentrer sur les principales fonctionnalités que vous souhaitez inclure dans votre application. Passons maintenant aux fonctionnalités liées aux signets dans les applications .NET :
Ajouter des signets dans un document PDF
L’ajout de signets est parfois un critère nécessaire lors de la soumission de documents, par exemple pour les dépôts juridiques. Dans de tels scénarios, vos applications peuvent suffire à répondre à tous vos besoins. Il vous suffit de spécifier les attributs ou les propriétés du signet et d’envoyer la demande d’insertion du signet dans le fichier PDF. Le code C# ci-dessous est une démonstration de l’utilisation de cette fonctionnalité :
// Obtenez AppKey et AppSID depuis https://dashboard.aspose.cloud/
// Installer le package Nuget Aspose.Pdf-Cloud
// Pour des exemples complets et des fichiers de données, veuillez consulter 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);
Ici, presque tous les attributs de la classe Bookmark sont explicites. Cependant, le paramètre bookmarkPath pointe vers le signet parent dans l’arborescence. Si vous souhaitez ajouter un signet à la racine, vous devez spécifier une chaîne vide comme chemin. Voici une capture d’écran du document PDF de sortie avec un signet ajouté par l’extrait de code ci-dessus.
Supprimer le signet dans le document PDF
Il est important de noter ici que la suppression d’un signet parent supprimera également tous ses signets enfants. Cependant, la suppression d’un signet ne supprime aucun texte ni aucune partie du document. Apprenons cela à l’aide d’un exemple en langage C# :
// Obtenez AppKey et AppSID depuis https://dashboard.aspose.cloud/
// Installer le package Nuget Aspose.Pdf-Cloud
// Pour des exemples complets et des fichiers de données, veuillez consulter 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);
Vous pouvez remarquer que nous devons simplement spécifier la propriété bookmarkPath, comme expliqué ci-dessus, avant d’appeler l’API.
Mettre à jour les signets dans le document PDF
Vous devrez peut-être mettre à jour les signets dans les documents PDF en renommant un signet, en mettant à jour la destination ou l’apparence. L’API est suffisamment avancée pour prendre en charge ces fonctionnalités également. L’extrait de code ci-dessous peut être utilisé pour mettre à jour les signets :
// Obtenez AppKey et AppSID depuis https://dashboard.aspose.cloud/
// Installer le package Nuget Aspose.Pdf-Cloud
// Pour des exemples complets et des fichiers de données, veuillez consulter 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);
Vous êtes curieux de découvrir d’autres fonctionnalités offertes par l’API ? Vous pouvez explorer certaines des possibilités dans la documentation de l’API. Si vous souhaitez tester l’API dans toute sa capacité, alors inscrivez-vous gratuitement et utilisez l’API avec l’essai gratuit généreux. Si vous avez des questions, n’hésitez pas à nous contacter via les Forums d’assistance gratuits.
Article connexe
Nous vous recommandons de visiter les liens suivants pour en savoir plus sur :