Comment accéder à tous les objets DOM du PDF en C

Comment accéder aux objets DOM dans les PDF?

L'objet ObjectModel est accessible depuis l'objet PdfPage. Tout d'abord, importez le PDF cible et accédez à sa propriété Pages. À partir de là, sélectionnez n'importe quelle page pour accéder à la propriété ObjectModel. Cela permet d'interagir avec le contenu PDF de manière programmatique, de la même manière que l'on travaille avec les éléments DOM de HTML.

Lorsque vous travaillez avec des objets DOM PDF, vous accédez à la structure sous-jacente du document PDF. Cela inclut les éléments de texte, les images, les graphiques vectoriels (paths) et tout autre contenu qui constitue la représentation visuelle de votre PDF. IronPDF propose une approche orientée objet de la manipulation des PDF qui s'intègre aux applications C#.

:path=/static-assets/pdf/content-code-examples/how-to/access-pdf-dom-object.cs

using IronPdf;
using System.Linq;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create a PDF from a URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");

// Access DOM Objects
var objects = pdf.Pages.First().ObjectModel;

La propriété ObjectModel contient ImageObject, PathObject et TextObject. Chaque objet contient des informations sur l'index de la page, la boîte englobante, l'échelle et la traduction. Ces informations peuvent être modifiées. Pour les options de rendu, vous pouvez personnaliser l'affichage de ces objets. Lorsque l'on travaille avec des marges personnalisées, il est important de comprendre le positionnement des objets.

<ImageObject>:

• Height: Hauteur de l'image
• Width: Largeur de l'image
• ExportBytesAsJpg: Méthode pour exporter l'image sous forme de tableau d'octets JPG

<PathObject>:

• FillColor: La couleur de remplissage du tracé
• StrokeColor: La couleur du trait
• Points: Ensemble de points définissant le chemin

<TextObject>:

• Color: La couleur du texte
• Contents: Le contenu textuel réel

Chaque type d'objet propose des méthodes et des propriétés adaptées à son type de contenu. Lorsque vous devez extraire du texte et des images ou modifier un contenu spécifique, ces objets offrent un contrôle granulaire. Cela est utile lorsque vous travaillez avec des formulaires PDF où vous devez manipuler des champs de formulaire de manière programmatique.

Comment récupérer les informations sur les glyphes et les boîtes de délimitation ?

Lorsqu'il s'agit de spécifier des glyphes exacts avec des polices personnalisées, il est essentiel de récupérer les informations relatives à la boîte de délimitation et aux glyphes. IronPDF fournit ces informations pour un positionnement au pixel près lorsque dessiner du texte et des bitmaps sur des PDF existants.

Accédez à l'objet ObjectModel depuis l'objet PdfPage. Accédez ensuite à la collection TextObjects. Appelez la méthode GetGlyphInfo pour récupérer les informations sur le glyphe et la boîte englobante.

:path=/static-assets/pdf/content-code-examples/how-to/access-pdf-dom-object-retrieve-glyph.cs

using IronPdf;
using System.Linq;

PdfDocument pdf = PdfDocument.FromFile("invoice.pdf");

var glyph = pdf.Pages.First().ObjectModel.TextObjects.First().GetGlyphInfo();

$vbLabelText   $csharpLabel

Les informations sur les glyphes comprennent des données de positionnement, des mesures de police et des détails spécifiques aux caractères pour une manipulation avancée des PDF. Cela permet de créer des applications de traitement PDF qui gèrent des exigences complexes en matière de typographie et de mise en page. Lorsque vous travaillez avec des polices personnalisées, cet accès au niveau des glyphes garantit un rendu précis sur l'ensemble des systèmes.

---

Comment traduire des objets PDF?

Ajustez la mise en page du PDF en repositionnant des éléments tels que du texte ou des images. Déplacez les objets en modifiant leur propriété Translate. Cette fonctionnalité fait partie des capacités de transformation de fichiers PDF d'IronPDF.

L'exemple ci-dessous rend HTML en utilisant CSS Flexbox pour centrer le texte. Il accède au premier TextObject et le traduit en attribuant un nouveau PointF à la propriété Translate. Le texte est ainsi décalé de 200 points vers la droite et de 150 points vers le haut. Pour plus d'exemples, visitez la page d'exemple de traduction d'objets PDF.

:path=/static-assets/pdf/content-code-examples/how-to/access-pdf-dom-object-translate.cs

using IronPdf;
using System.Drawing;
using System.Linq;

// Setup the Renderer
var renderer = new ChromePdfRenderer();

// We use CSS Flexbox to perfectly center the text vertically and horizontally.
var html = @"
<div style='display: flex; justify-content: center; align-items: center; font-size: 48px;'>
    Centered
</div>";

// Render the HTML to a PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Save the original PDF to see the "before" state
pdf.SaveAs("BeforeTranslate.pdf");

// Access the first text object on the first page
// In this simple HTML, this will be our "Centered" text block.
var textObject = pdf.Pages.First().ObjectModel.TextObjects.First();

// Apply the translation
// This moves the object 200 points to the right and 150 points up from its original position.
textObject.Translate = new PointF(200, 150);

// Save the modified PDF to see the "after" state
pdf.SaveAs("AfterTranslate.pdf");

À quoi ressemble le résultat de la traduction?

Le résultat montre que "Centered" est décalé de 200 points vers la droite et de 150 points vers le haut par rapport à sa position d'origine.

Les opérations de traduction conservent les propriétés originales de l'objet, telles que la police, la taille et la couleur, et ne modifient que la position. La traduction est idéale pour les ajustements de mise en page sans affecter l'apparence visuelle. Cette fonctionnalité fonctionne avec les en-têtes et les pieds de page lors du repositionnement du contenu généré dynamiquement.

---

Comment mettre à l'échelle des objets PDF?

Redimensionnez les objets PDF à l'aide de la propriété Scale. Cette propriété agit comme un multiplicateur. Les valeurs supérieures à 1 augmentent la taille, tandis que les valeurs comprises entre 0 et 1 la diminuent. La mise à l'échelle est essentielle pour les mises en page dynamiques et l'ajustement du contenu aux dimensions de la page. Voir le guide des objets PDF à l'échelle pour plus d'exemples.

L'exemple rend du HTML contenant une image. Il accède au premier ImageObject et le met à l'échelle à 70 % en attribuant à Scale un nouveau PointF avec 0,7 pour les deux axes.

:path=/static-assets/pdf/content-code-examples/how-to/access-pdf-dom-object-scale.cs

using IronPdf;
using System.Linq;

// Setup the Renderer
var renderer = new ChromePdfRenderer();

// The image is placed in a div to give it some space on the page.
string html = @"<img src='https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTi8LuOR6_A98euPLs-JRwoLU7Nc31nVP15rw&s'>";

// Render the HTML to a PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Save the PDF before scaling for comparison
pdf.SaveAs("BeforeScale.pdf");

// Access the first image object on the first page
var image = pdf.Pages.First().ObjectModel.ImageObjects.First();

// We scale the image to 70% of its original size on both the X and Y axes.
image.Scale = new System.Drawing.PointF(0.7f, 0.7f);

// Save the modified PDF to see the result
pdf.SaveAs("AfterScale.pdf");

À quoi ressemble la mise à l'échelle en pratique?

La sortie montre l'image redimensionnée à 70 % de sa taille d'origine.

---

Comment supprimer les objets PDF?

Supprimez les objets en accédant à la collection DOM PDF comme ImageObjects ou TextObjects. Appelez RemoveAt sur la collection, en passant l'index de l'objet à supprimer. Elle est utile pour expurger le contenu ou simplifier les documents. Pour en savoir plus, consultez l'exemple supprimer les objets PDF.

Le code charge le fichier BeforeScale.pdf et supprime la première image de la première page.

:path=/static-assets/pdf/content-code-examples/how-to/access-pdf-dom-object-remove.cs

using IronPdf;
using System.Linq;

// Load the PDF file we created in the Scale example
PdfDocument pdf = PdfDocument.FromFile("BeforeScale.pdf");

// Access DOM Objects
var objects = pdf.Pages.First().ObjectModel;

// Remove first image
objects.ImageObjects.RemoveAt(0);

// Save the modified PDF
pdf.SaveAs("removedFirstImage.pdf");

Comment combiner plusieurs opérations DOM?

L'accès DOM d'IronPDF permet de mettre en place des flux de traitement de documents sophistiqués. Combinez les opérations pour les transformations complexes :

// Example of combining multiple DOM operations
using IronPdf;
using System.Linq;

PdfDocument pdf = PdfDocument.FromFile("complex-document.pdf");

// Iterate through all pages
foreach (var page in pdf.Pages)
{
    var objects = page.ObjectModel;

    // Process text objects
    foreach (var textObj in objects.TextObjects)
    {
        // Change color of specific text
        if (textObj.Contents.Contains("Important"))
        {
            textObj.Color = System.Drawing.Color.Red;
        }
    }

    // Scale down all images by 50%
    foreach (var imgObj in objects.ImageObjects)
    {
        imgObj.Scale = new System.Drawing.PointF(0.5f, 0.5f);
    }
}

pdf.SaveAs("processed-document.pdf");

// Example of combining multiple DOM operations
using IronPdf;
using System.Linq;

PdfDocument pdf = PdfDocument.FromFile("complex-document.pdf");

// Iterate through all pages
foreach (var page in pdf.Pages)
{
    var objects = page.ObjectModel;

    // Process text objects
    foreach (var textObj in objects.TextObjects)
    {
        // Change color of specific text
        if (textObj.Contents.Contains("Important"))
        {
            textObj.Color = System.Drawing.Color.Red;
        }
    }

    // Scale down all images by 50%
    foreach (var imgObj in objects.ImageObjects)
    {
        imgObj.Scale = new System.Drawing.PointF(0.5f, 0.5f);
    }
}

pdf.SaveAs("processed-document.pdf");

Comment DOM Access se compare-t-il aux autres méthodes de manipulation des PDF ?

Travailler avec PDF DOM présente des avantages par rapport aux approches traditionnelles :

// Example: Selective content modification based on criteria
using IronPdf;
using System.Linq;

PdfDocument report = PdfDocument.FromFile("quarterly-report.pdf");

foreach (var page in report.Pages)
{
    var textObjects = page.ObjectModel.TextObjects;

    // Highlight negative values in financial reports
    foreach (var text in textObjects)
    {
        if (text.Contents.StartsWith("-$") || text.Contents.Contains("Loss"))
        {
            text.Color = System.Drawing.Color.Red;
        }
    }
}

report.SaveAs("highlighted-report.pdf");

// Example: Selective content modification based on criteria
using IronPdf;
using System.Linq;

PdfDocument report = PdfDocument.FromFile("quarterly-report.pdf");

foreach (var page in report.Pages)
{
    var textObjects = page.ObjectModel.TextObjects;

    // Highlight negative values in financial reports
    foreach (var text in textObjects)
    {
        if (text.Contents.StartsWith("-$") || text.Contents.Contains("Loss"))
        {
            text.Color = System.Drawing.Color.Red;
        }
    }
}

report.SaveAs("highlighted-report.pdf");

Ce contrôle granulaire n'est pas possible avec la seule conversion HTML en PDF, ce qui rend l'accès au DOM essentiel pour un traitement sophistiqué des PDF.

Prêt à voir ce que vous pouvez faire d'autre? Consultez la page du tutoriel ici : Éditer des PDF