Utilisation des paragraphes

Article
11/16/2023

Cette rubrique décrit la classe Paragraph du Kit de développement logiciel (SDK) Open XML et sa relation avec le schéma WordprocessingML au format de fichier Open XML.

Paragraphes dans WordprocessingML

Le texte suivant de la spécification ISO/IEC 29500 présente l’élément WordprocessingML Open XML utilisé pour représenter un paragraphe dans un document WordprocessingML.

Unité de base du contenu au niveau du bloc dans un document WordprocessingML, les paragraphes sont stockés à l’aide de l’élément <p> . Un paragraphe définit une division distincte de contenu qui commence sur une nouvelle ligne. Un paragraphe peut contenir trois éléments d’information : des propriétés facultatives du paragraphe, du contenu en ligne (généralement des séquences) et un ensemble d’ID de révision facultatifs utilisés pour comparer le contenu de deux documents.

Les propriétés d’un paragraphe sont spécifiées via l’élément <pPr>. L’alignement, la bordure, le remplacement de coupure des mots, l’indentation, l’espacement des lignes, l’ombrage, l’orientation du texte ainsi que l’évitement des veuves et orphelines sont des exemples de propriétés d’un paragraphe.

Le tableau suivant présente les classes du Kit de développement Open XML SDK les plus couramment utilisées avec les paragraphes.

Élément WordprocessingML	Classe du Kit de développement logiciel (SDK) Open XML
p	Paragraphe
Ppr	Paragraphproperties
r	Exécuter
t	Texte

Classe Paragraph

La classe Paragraph du Kit de développement logiciel (SDK) Open XML représente l’élément paragraphe (<p>) défini dans le schéma de format de fichier Open XML pour les documents WordprocessingML, comme indiqué ci-dessus. Utilisez l’objet Paragraph pour manipuler des éléments p> individuels < dans un document WordprocessingML.

Classe ParagraphProperties

Dans WordprocessingML, les propriétés d’un paragraphe sont spécifiées via l’élément propriétés de paragraphe (<pPr>). L’alignement, la bordure, le remplacement de coupure des mots, l’indentation, l’espacement des lignes, l’ombrage, l’orientation du texte ainsi que l’évitement des veuves et orphelines sont des exemples de propriétés d’un paragraphe. La classe ParagraphProperties du Kit de développement logiciel (SDK) OXML représente l’élément <pPr> .

Classe Run

Les paragraphes d’un document de traitement de texte contiennent le plus souvent du texte. Dans le schéma de format de fichier OXML pour les documents WordprocessingML, l’élément run (<r>) est fourni pour délimiter une région de texte. La classe Run du Kit de développement logiciel (SDK) OXML représente l’élément <r> .

Objet Text

Avec l’élément <r> , l’élément text (<t>) est le conteneur du texte qui compose le contenu du document. La classe Text du Kit de développement logiciel (SDK) OXML représente l’élément <t> .

Exemple de code du Kit de développement logiciel (SDK) Open XML

Le code suivant instancie un objetParagraph du Kit de développement logiciel (SDK) Open XML, puis l’utilise pour ajouter du texte à un document WordprocessingML.

C#
Visual Basic

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using System;

WriteToWordDoc(args[0], args[1]);

static void WriteToWordDoc(string filepath, string txt)
{
    // Open a WordprocessingDocument for editing using the filepath.
    using (WordprocessingDocument wordprocessingDocument = WordprocessingDocument.Open(filepath, true))
    {
        if (wordprocessingDocument is null)
        {
            throw new ArgumentNullException(nameof(wordprocessingDocument));
        }
        // Assign a reference to the existing document body.
        MainDocumentPart mainDocumentPart = wordprocessingDocument.MainDocumentPart ?? wordprocessingDocument.AddMainDocumentPart();
        mainDocumentPart.Document ??= new Document();
        Body body = mainDocumentPart.Document.Body ?? mainDocumentPart.Document.AppendChild(new Body());

        // Add a paragraph with some text.
        Paragraph para = body.AppendChild(new Paragraph());
        Run run = para.AppendChild(new Run());
        run.AppendChild(new Text(txt));
    }
}

Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Wordprocessing

Module MyModule

    Sub Main(args As String())
    End Sub

    Public Sub WriteToWordDoc(ByVal filepath As String, ByVal txt As String)
        ' Open a WordprocessingDocument for editing using the filepath.
        Using wordprocessingDocument As WordprocessingDocument =
            WordprocessingDocument.Open(filepath, True)
            ' Assign a reference to the existing document body.
            Dim body As Body = wordprocessingDocument.MainDocumentPart.Document.Body

            ' Add a paragraph with some text.            
            Dim para As Paragraph = body.AppendChild(New Paragraph())
            Dim run As Run = para.AppendChild(New Run())
            run.AppendChild(New Text(txt))
        End Using

    End Sub
End Module

Lorsque ce code est exécuté, le code XML suivant est écrit dans le document WordprocessingML référencé dans le code.

    <w:p>
      <w:r>
        <w:t>String from WriteToWordDoc method.</w:t>
      </w:r>
    </w:p>

Voir aussi

À propos du Kit de développement logiciel (SDK) Open XML pour Office

Utilisation des séquences

Appliquer un style à un paragraphe dans un document de traitement de texte

Procédure : Ouvrir et ajouter du texte à un document de traitement de texte

Partager via