Tutoriel sur les éléments de document

Chaknith Bin

janvier 9, 2024

Mise à jour janvier 9, 2025

Translated

View the article in English

IronWord est une puissante bibliothèque de documents Word conçue pour aider les développeurs .NET C# à intégrer les capacités de création, de lecture et d'édition de documents Word et DOCX dans leurs applications. Dans le contexte d'un document Word, les éléments du document sont les éléments constitutifs du contenu.

Table des matières

Ajouter du texte
- Contenu du texte (Ajouter, ajouter et diviser)
- Style des décors (Famille et taille de police, Couleur, Gras et Italique, Barré, Souligné, Exposé et Indice)
Intégrer des images
Ajouter des images
- Charger l'image (Fichier et FileStream)
- Définir un texte enveloppant
- Dimensions de l'ensemble (Largeur et hauteur)
- Définir le décalage de position
- Définir la distance par rapport aux coins
  Commencez avec IronWORD
  
  Commencez à utiliser IronWord dans votre projet dès aujourd'hui avec un essai gratuit.
  
  Première étape :
  
  Commencer gratuitement

Ajouter des TextRuns

Contenu du texte

La méthode Split est utilisée pour diviser le texte en une liste de TextRuns plus petits, sur la base d'un délimiteur spécifié. Cela permet d'organiser et de manipuler l'information textuelle dans le document.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));

// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

// Export docx
doc.SaveAs("textrun.docx");

Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))

' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

' Export docx
doc.SaveAs("textrun.docx")

$vbLabelText $csharpLabel

Style des décors

La définition d'un style pour les TextRuns permet de définir la présentation visuelle du texte. Il s'agit de spécifier des attributs tels que la taille de la police, la couleur, le style, le barré, le souligné, l'exposant et l'indice. La configuration du style améliore l'aspect général du texte dans le document.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
TextContent textRun = new TextContent();
textRun.Text = "Add text using IronWord";
textRun.Style = new TextStyle()
{
    TextFont = new Font()
    {
        FontFamily = "Caveat",
        FontSize = 72,
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddText(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Private doc As New WordDocument("document.docx")

' Configure text
Private textRun As New TextContent()
textRun.Text = "Add text using IronWord"
textRun.Style = New TextStyle() With {
	.TextFont = New Font() With {
		.FontFamily = "Caveat",
		.FontSize = 72
	},
	.Color = Color.Red,
	.IsBold = True,
	.IsItalic = True,
	.Underline = New Underline(),
	.Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddText(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")

$vbLabelText $csharpLabel

Intégrer des images

Cette fonction vous permet d'inclure des images de manière transparente dans le contenu, ce qui améliore l'attrait visuel global et le pouvoir de communication du document.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();

// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

// Add paragraph
doc.AddParagraph(new Paragraph(textRun));

// Export docx
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

' Configure image
Private image As New ImageContent("image.jpg")
image.Width = 200 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim textRun As New TextContent()

' Add image
Dim para As New Paragraph(textRun)
para.AddImage(image)

' Add paragraph
doc.AddParagraph(New Paragraph(textRun))

' Export docx
doc.SaveAs("save_document.docx")

$vbLabelText $csharpLabel

Ajouter des images

Charger l'image

Le chargement des images est un processus crucial. Il s'agit d'intégrer des fichiers d'images externes dans le document. La possibilité de charger des images facilite l'inclusion de visuels pertinents, ce qui contribue à rendre le document plus attrayant et plus informatif.

:path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage("image.jpg");

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

' Add image
paragraph.AddImage("image.jpg")

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")

$vbLabelText $csharpLabel

Configurer l'image

Optimisez les images grâce à des paramètres configurables. Il s'agit notamment de définir des propriétés telles que l'habillage du texte, les dimensions, la position et la distance par rapport aux coins. Une configuration adéquate garantit que les images sont affichées d'une manière agréable à l'œil et adaptée au contexte.

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.WrapText = WrapText.Square;
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Private doc As New WordDocument()

' Configure image
Private image As New ImageContent("image.jpg")
image.WrapText = WrapText.Square
image.Width = 100
image.Height = 100
image.DistanceFromTop = 50

Dim position = New ElementPosition()
position.X = 50
position.Y = 50
image.Position = position

Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")

$vbLabelText $csharpLabel

Chaknith Bin

Discutez avec l'équipe d'ingénierie maintenant

Ingénieur logiciel

Chaknith travaille sur IronXL et IronBarcode. Il possède une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, une documentation améliorée et une expérience globale enrichie.