Obtenir et définir les propriétés de la page

Aspose.PDF pour .NET vous permet de lire et de définir les propriétés des pages dans un fichier PDF dans vos applications .NET. Cette section montre comment obtenir le nombre de pages dans un fichier PDF, obtenir des informations sur les propriétés des pages PDF telles que la couleur et définir les propriétés des pages. Les exemples donnés sont en C#, mais vous pouvez utiliser n’importe quel langage .NET comme VB.NET pour obtenir le même résultat.

Le code suivant fonctionne également avec la bibliothèque Aspose.PDF.Drawing.

Obtenir le Nombre de Pages dans un Fichier PDF

Lorsque vous travaillez avec des documents, vous voulez souvent savoir combien de pages ils contiennent. Avec Aspose.PDF, cela ne prend pas plus de deux lignes de code.

Pour obtenir le nombre de pages dans un fichier PDF :

1. Ouvrez le fichier PDF en utilisant la classe Document.
2. Utilisez ensuite la propriété Count de la collection PageCollection (de l’objet Document) pour obtenir le nombre total de pages dans le document.

Le code suivant montre comment obtenir le nombre de pages d’un fichier PDF. Le code suivant montre comment obtenir le nombre de pages d’un fichier PDF.

Obtenir le nombre de pages sans sauvegarder le document

Parfois, nous générons des fichiers PDF à la volée et lors de la création de fichiers PDF, nous pouvons rencontrer le besoin (création de la Table des Matières, etc.) d’obtenir le nombre de pages du fichier PDF sans sauvegarder le fichier sur le système ou le flux. Pour répondre à ce besoin, une méthode ProcessParagraphs a été introduite dans la classe Document. Veuillez regarder le code suivant qui montre les étapes pour obtenir le nombre de pages sans sauvegarder le document.

Obtenir les propriétés de la page

Chaque page d’un fichier PDF possède un certain nombre de propriétés, telles que la largeur, la hauteur, les boîtes de saignement, de coupe et de rognage. Chaque page d’un fichier PDF possède un certain nombre de propriétés, telles que la largeur, la hauteur, le fond perdu, la boîte de rognage et la boîte de coupe.

Comprendre les propriétés des pages : la différence entre Artbox, BleedBox, CropBox, MediaBox, TrimBox et la propriété Rect

• Boîte de média : La boîte de média est la plus grande boîte de page. Elle correspond à la taille de la page (par exemple A4, A5, Lettre US, etc.) sélectionnée lors de l’impression du document en PostScript ou PDF. En d’autres termes, la boîte de média détermine la taille physique du support sur lequel le document PDF est affiché ou imprimé.
• Boîte de fond perdu : Si le document comporte un fond perdu, le PDF aura également une boîte de fond perdu. Le fond perdu est la quantité de couleur (ou d’œuvre d’art) qui dépasse le bord d’une page. Il est utilisé pour s’assurer que lorsque le document est imprimé et coupé à la taille (« rogné »), l’encre ira jusqu’au bord de la page. Même si la page est mal coupée - légèrement décalée par rapport aux marques de coupe - aucun bord blanc n’apparaîtra sur la page.
• Boîte de coupe : La boîte de coupe indique la taille finale d’un document après impression et rognage.
• Trim box : Le trim box indique la taille finale d’un document après impression et découpe.
• Art box : L’art box est la boîte dessinée autour du contenu réel des pages de vos documents. Cette boîte de page est utilisée lors de l’importation de documents PDF dans d’autres applications.
• Crop box : La crop box est la taille de “page” à laquelle votre document PDF est affiché dans Adobe Acrobat. En vue normale, seul le contenu de la crop box est affiché dans Adobe Acrobat. Pour des descriptions détaillées de ces propriétés, consultez la spécification Adobe.Pdf, en particulier 10.10.1 Limites de page.
• Page.Rect : l’intersection (rectangle communément visible) du MediaBox et du DropBox. L’image ci-dessous illustre ces propriétés.

Pour plus de détails, veuillez visiter cette page.

Accéder aux propriétés de la page

La classe Page fournit toutes les propriétés liées à une page PDF particulière. La classe Page fournit toutes les propriétés relatives à une page PDF particulière.

À partir de là, il est possible d’accéder soit à des objets Page individuels en utilisant leur index, soit de parcourir la collection, en utilisant une boucle foreach, pour obtenir toutes les pages. Une fois qu’une page individuelle est accédée, nous pouvons obtenir ses propriétés. Le fragment de code suivant montre comment obtenir les propriétés d’une page.

Obtenir une Page Particulière du Fichier PDF

Aspose.PDF permet de diviser un PDF en pages individuelles et de les enregistrer en tant que fichiers PDF. Obtenir une page spécifiée dans un fichier PDF et l’enregistrer comme un nouveau PDF est une opération très similaire : ouvrir le document source, accéder à la page, créer un nouveau document et ajouter la page à celui-ci.

L’objet Document avec sa PageCollection contient les pages du fichier PDF. L’objet Document contient la PageCollection qui détient les pages du fichier PDF.

1. Spécifiez l’indice de la page en utilisant la propriété Pages.
2. Créez un nouvel objet Document.
3. Ajoutez l’objet Page au nouvel objet Document.
4. Sauvegardez le résultat en utilisant la méthode Save.

Le code suivant montre comment obtenir une page particulière d’un fichier PDF et la sauvegarder comme un nouveau fichier.

Déterminer la couleur de la page

La classe Page fournit les propriétés liées à une page particulière dans un document PDF, y compris le type de couleur - RVB, noir et blanc, niveaux de gris ou indéfini - utilisé par la page. La classe Page fournit les propriétés relatives à une page particulière dans un document PDF, y compris le type de couleur - RVB, noir et blanc, niveaux de gris ou indéfini - utilisée par la page.

Toutes les pages des fichiers PDF sont contenues par la collection PageCollection. La propriété ColorType spécifie la couleur des éléments sur la page. Pour obtenir ou déterminer les informations de couleur pour une page PDF particulière, utilisez la propriété ColorType de l’objet Page.

Le code suivant montre comment itérer à travers chaque page individuelle d’un fichier PDF pour obtenir des informations sur la couleur.