Page – Aspose FOSS API Reference

Page

Vue d’ensemble

Page est une classe dans Aspose.PDF FOSS pour .NET. Hérite de : IDisposable.

Représente une page dans un document PDF.

Cette classe fournit 53 méthodes pour travailler avec des objets Page dans les programmes .NET. Les méthodes disponibles incluent : Accept, AddContent, AddContentStream, AddExtGState, AddFloatingBox, AddGraph, AddGraphics, AddImage, AddStamp, AddTable, AsByteArray, AsXml, et 27 méthodes supplémentaires. Tous les membres publics sont accessibles à toute application .NET après l’installation du package Aspose.PDF FOSS for .NET. Propriétés : Actions, Annotations, ArtBox, Artifacts, Background, BackgroundImage, et 34 de plus.

Propriétés

Nom	Type	Accès	Description
`Number`	`int`	Read	Numéro de page basé sur 1.
`FieldsInTabOrder`	`IList<Forms.Field>`	Read	Champs de formulaire dont les widgets apparaissent sur cette page, ordonnés selon leur ordre de tabulation.
`Rect`	`Rectangle`	Read/Write	Rectangle de la page (par défaut MediaBox).
`Rectangle`	`Rectangle`	Read/Write	Le rectangle de la page.
`PageInfo`	`PageInfo`	Read/Write	Conteneur d’informations de page avec les propriétés largeur/hauteur/marge.
`Background`	`Color?`	Read/Write	Obtient ou définit l’arrière-plan.
`MediaBox`	`Rectangle`	Read/Write	La MediaBox pour cette page (obligatoire selon la spécification).
`CropBox`	`Rectangle`	Read/Write	La CropBox (par défaut la MediaBox).
`BleedBox`	`Rectangle`	Read/Write	La BleedBox (par défaut la CropBox).
`TrimBox`	`Rectangle`	Read/Write	La TrimBox (par défaut la CropBox).
`ArtBox`	`Rectangle`	Read/Write	La ArtBox (par défaut la CropBox).
`Rotate`	`Rotation`	Read/Write	Rotation de la page en tant qu’énumération Rotation.
`RotateDegrees`	`int`	Read/Write	Rotation de la page en degrés sous forme d’entier (0, 90, 180, 270).
`RotationMatrix`	`Matrix`	Read	Transformation affine qui mappe le système de coordonnées PDF non rotatif vers celui visible par l’utilisateur (rotatif) de la page.
`Duration`	`double`	Read/Write	Durée d’affichage de la page en secondes pour le mode présentation.
`Annotations`	`AnnotationCollection`	Read	Annotations sur cette page.
`Images`	`XImageCollection`	Read	XObjects d’image sur cette page.
`Fonts`	`FontCollection`	Read	Polices référencées par cette page.
`Resources`	`Resources`	Read	Ressources de la page (polices, images) — fournit l’accès via un objet Resources unifié.
`Patterns`	`IReadOnlyDictionary<string, Pattern>`	Read	Ressources de motifs sur cette page (indexées par le nom du motif).
`Contents`	`OperatorCollection`	Read	Collection d’opérateurs du flux de contenu.
`Width`	`double`	Read	Largeur visible de la page en tenant compte de la rotation.
`Height`	`double`	Read	Hauteur visible de la page en tenant compte de la rotation.
`ColorType`	`ColorType`	Read	Obtient le type de couleur de cette page en analysant les opérateurs du flux de contenu et les espaces colorimétriques des images.
`Transition`	`PageTransition?`	Read	L’effet de transition de la page, ou null si aucun n’est défini.
`Header`	`HeaderFooter?`	Read/Write	En-tête à rendre en haut de cette page.
`Footer`	`HeaderFooter?`	Read/Write	Pied de page à rendre en bas de cette page.
`TocInfo`	`TocInfo?`	Read/Write	Informations de la table des matières pour cette page.
`Paragraphs`	`Paragraphs`	Read/Write	Collection d’objets paragraphe à ajouter à cette page (TextFragment, HtmlFragment, Table, Heading, etc.).
`NoteLineStyle`	`GraphInfo`	Read/Write	Style de trait/remplissage par défaut utilisé pour dessiner les lignes séparatrices de notes de bas de page / notes de fin.
`Artifacts`	`ArtifactCollection`	Read	Collection pour ajouter des artefacts (filigranes, etc.) à cette page.
`OcgLayers`	`LayerCollection`	Read	Obtient les calques (Groupes de contenu optionnels) référencés par cette page.
`Actions`	`PageActionCollection`	Read	Actions supplémentaires par page (ouverture / fermeture / etc.).
`UserUnit`	`double`	Read/Write	Facteur d’unité utilisateur (PDF 32000 §14.8.4 / entrée UserUnit).
`IsAddParagraphsAfterLast`	`bool`	Read/Write	Indique si les ajouts de Paragraphs s’ajoutent à la fin (vs position de flux).
`BackgroundImage`	`Image?`	Read/Write	Image d’arrière-plan de la page.
`Group`	`Group?`	Read/Write	Dictionnaire de groupe / espace colorimétrique de fusion pour cette page.
`TabOrder`	`TabOrder`	Read/Write	Ordre de tabulation (PDF 32000 §12.5 / entrée Tabs).
`Watermark`	`Watermark?`	Read/Write	Filigrane appliqué à cette page.
`Layers`	`System.Collections.Generic.List<Layer>`	Read/Write	Liste réelle de calques effective soutenue par OcgLayers — chaque OCG référencé par la page est matérialisé en instance Layer.

Méthodes

Signature	Description
`SetRotation(degrees: int)`	Définir la rotation de la page en degrés (0, 90, 180, 270).
`SetMediaBox(rect: Rectangle)`	Définir la boîte média pour cette page.
`SetCropBox(rect: Rectangle)`	Définir la boîte de rognage pour cette page.
`SetBleedBox(rect: Rectangle)`	Définir la boîte de débordement pour cette page.
`SetTrimBox(rect: Rectangle)`	Définir la boîte de découpe pour cette page.
`SetArtBox(rect: Rectangle)`	Définir la boîte artistique pour cette page.
`Accept(visitor: Annotations.AnnotationSelector)`	Parcourir chaque annotation de cette page avec le visiteur ; les correspondances s’accumulent dans Selected.
`GetResources()`	Accesseur de style méthode pour Resources.
`SetPageSize(width: double, height: double)`	Définir la taille de la page en mettant à jour la MediaBox.
`GetPageRect(considerRotation: bool)`	Obtenir le rectangle de la page, en tenant éventuellement compte de la CropBox.
`Accept(visitor: Text.TextAbsorber)`	Accepter un visiteur TextAbsorber (conforme à l’API publique).
`GetText()`	Extraire tout le texte de la page à l’aide d’un TextAbsorber.
`Accept(visitor: Text.TextFragmentAbsorber)`	Accepter un visiteur TextFragmentAbsorber (conforme à l’API publique).
`Accept(visitor: ImagePlacementAbsorber)`	Accepter un visiteur ImagePlacementAbsorber (conforme à l’API publique).
`SendTo(device: Devices.ImageDevice, outputFileName: string)`	Ajouter un tampon à cette page.
`SendTo(device: Devices.ImageDevice, output: Stream)`	Rendre cette page en utilisant le dispositif spécifié et écrire dans un flux.
`AddStamp(stamp: ImageStamp)`	Appliquer un tampon d’image à cette page.
`AddStamp(stamp: Aspose.Pdf.Stamps.Stamp)`	Appelle AddStamp sur cette instance de Page.
`AddContentStream(contentBytes: byte[])`	Ajouter un flux de contenu à cette page.
`PrependContentStream(contentBytes: byte[])`	Préfixer les octets du flux de contenu avant le contenu existant de la page (pour les éléments d’arrière-plan).
`AddContent(contentStreamBytes: byte[])`	Ajouter des octets de flux de contenu à cette page.
`AddTable(table: Table)`	Ajouter un tableau à cette page.
`AddGraph(graph: Drawing.Graph)`	Ajouter un graphique (collection de formes) à cette page.
`AddFloatingBox(box: FloatingBox)`	Ajouter une boîte flottante à cette page.
`AddExtGState(extGState: Content.ExtGState)`	Ajouter un dictionnaire ExtGState aux ressources de cette page et renvoyer le nom de la ressource.
`AddImage(imageData: byte[], rect: Rectangle)`	Ajouter une image à cette page à la position et à la taille spécifiées.
`AddImage(imageStream: Stream, rect: Rectangle)`	Ajouter une image depuis un flux à cette page à la position et à la taille spécifiées.
`AddImage(imagePath: string, rectangle: Rectangle)`	Ajouter une image depuis un chemin de fichier au rectangle spécifié.
`AddImage(imageStream: Stream, imageRect: Rectangle, bbox: Rectangle, autoAdjustRectangle: bool)`	Ajouter une image à imageRect avec une boîte englobante explicite.
`AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool, bbox: Rectangle)`	Ajouter une image avec une taille de pixel explicite + boîte englobante.
`AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle, bbox: Rectangle)`	Ajouter une image accompagnée d’une chaîne HOCR (superposition OCR).
`Resize(targetSize: Aspose.Pdf.PageSize)`	Redimensionner cette page à targetSize via la mise à jour de la media-box.
`AsByteArray(resolution: Aspose.Pdf.Devices.Resolution)`	Rendre cette page dans un tableau d’octets PNG à la résolution demandée.
`Flatten()`	Aplatir toutes les annotations de cette page — rendre leur apparence visuelle dans le flux de contenu de la page et les supprimer du tableau d’annotations.
`ConvertToPNGMemoryStream()`	Détermine si la page est vide (n’a aucun contenu significatif).
`IsBlank(fillThresholdFactor: double)`	Appelle IsBlank sur cette instance de Page.
`MergeLayers(newLayerName: string)`	Fusionner toutes les calques de cette page en un seul calque avec le nom donné.
`MergeLayers(newLayerName: string, newOptionalContentGroupId: string)`	Fusionner toutes les calques de cette page, en attribuant au nouvel OCG l’ID donné.
`HasVectorGraphics()`	Indique si cette page contient des graphiques vectoriels.
`TrySaveVectorGraphics(pathToSave: string)`	Enregistrer les graphiques vectoriels de cette page vers pathToSave.
`AsXml()`	Représentation XML de diagnostic de cette page.
`GetNotifications()`	Texte de notification fourni par le Saver émis lors du rendu de cette page.
`MakeGrayscale()`	Convertir chaque remplissage/trait coloré de cette page en niveaux de gris.
`IntToRotation(rotation: int)`	Convertir une rotation en degrés (int) en Rotation.
`RotationToInt(rotation: Rotation)`	Convertir Rotation en degrés sous forme d’int.
`FreeMemory()`	Efface les données en cache.
`Dispose()`	Libère la mémoire.
`CalculateContentBBox()`	Calculer le plus petit rectangle aligné sur les axes dans l’espace de la page englobant tout le contenu peint sur cette page (texte, tracés vectoriels, images, images en ligne, récursivement via les Form XObjects).
`SendTo(device: PageDevice, output: Stream)`	Rendre cette page via un PageDevice vers un flux.
`SendTo(device: PageDevice, outputFileName: string)`	Rendre cette page via un PageDevice vers un fichier.
`AddStamp(stamp: Stamp)`	Appliquer le tampon via son remplacement Put(Page).
`AddGraphics(elements: GraphicElementCollection, rectangle: Rectangle)`	L’émission d’éléments vectoriels n’est pas implémentée — le rendu ne consomme pas encore GraphicElementCollection.
`DeleteGraphics(elementsToDelete: GraphicElementCollection)`	Idem — la suppression d’éléments vectoriels n’est pas connectée.

Voir aussi

Aspose.PDF for .NET — Référence de l’API d’entreprise