Comment ajouter du style à un texte dans un document DOCX avec C

Comment ajouter un style de texte à DOCX?

Appliquer des styles de texte dans IronWord est simple. Créez un objet WordDocument , puis créez un objet TextContent avec votre texte. Appliquez un TextStyle à l'aide de propriétés telles que IsBold, Color ou TextFont, et améliorez le style à l'aide d'options telles que le soulignement ou le barré.

Une fois stylisé, ajoutez du texte à un Paragraphe, insérez le paragraphe dans le document et enregistrez le résultat. Cette approche permet un contrôle programmatique de la mise en forme du texte pour les scénarios de génération automatique de documents nécessitant une mise en forme cohérente.

:path=/static-assets/word/content-code-examples/how-to/add-style-text-simple.cs

using IronWord;

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

// Configure text
TextContent text = new TextContent();
text.Text = "Add text using IronWord";

// Configure text style settings
text.Style = new TextStyle()
{
    TextFont = new Font()
    {
        FontFamily = "Calibri", // Text Font is "Calibri"
        FontSize = 24, // Text Size is 24
    },
    Color = Color.Red, // Set text color to red
    IsBold = true,     // Make text bold
    IsItalic = true,   // Make text italic
	Underline = new Underline(), // Have an underline
    Strike = StrikeValue.DoubleStrike, // No strike-through
};

Paragraph paragraph = new Paragraph();

// Add text to paragraph
paragraph.AddText(text);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Save document
doc.SaveAs("add-text-style.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Quel sera le résultat de cette traduction ?

La classe `TextStyle` fournit des options de mise en forme essentielles, notamment les propriétés de police, la couleur du texte, le gras, l'italique et le souligné. L'exemple montre comment plusieurs propriétés de style se combinent pour créer un texte richement formaté.

---

Quels sont les styles spécifiques que je peux ajouter ? ### Comment changer la couleur du texte? La propriété `Color` dans `TextStyle` définit la couleur du texte en utilisant des couleurs prédéfinies à partir de `IronWord.Models.Color` ou des valeurs hexagonales personnalisées. Elle doit mettre l'accent sur un contenu spécifique ou correspondre aux couleurs de la marque. IronWord prend en charge une large gamme de couleurs, notamment le rouge, le bleu, le vert, l'olive, le marine et le bordeaux. ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-text.cs ``` ### À quoi ressemble un texte coloré?

### Comment définir la famille et la taille des polices de caractères ? Personnalisez l'apparence du texte grâce à la propriété `TextFont` . Définissez `FontFamily` sur n'importe quel nom de police installé (par exemple, " Arial ", " Times New Roman ") et `FontSize` en points. Cela permet d'établir une hiérarchie visuelle et de garantir la lisibilité sur différents appareils et plateformes. ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-font.cs ``` ### À quoi ressemble un style de police personnalisé?

### Comment mettre un texte en gras? Définissez la propriété `IsBold` sur `true` pour mettre le texte en gras. Le texte en gras est généralement utilisé pour les titres, l'accentuation ou la mise en évidence d'informations importantes. Combiné à d'autres propriétés stylistiques, le texte en gras crée une hiérarchie visuelle et améliore la lisibilité. ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-bold.cs ``` ### À quoi ressemble un texte en gras?

### Comment mettre un texte en italique? Définissez la propriété `IsItalic` sur `true` pour le style italique. Le texte en italique est généralement utilisé pour mettre l'accent, pour les titres, les mots étrangers ou les termes techniques. Cette mise en forme subtile différencie les éléments du texte sans le poids visuel de la mise en forme en gras. ```csharp :path=/static-assets/word/content-code-examples/how-to/add-style-text-add-italic.cs ``` ### À quoi ressemble un texte en italique?

---

Quelles sont les propriétés de style disponibles ? IronWord offre des propriétés de style complètes qui reflètent les options de formatage de Microsoft Word. Ces propriétés se combinent pour créer une mise en forme de texte complexe répondant aux normes des documents professionnels.

Méthode de stylisation	Description du projet	Exemple d'application
TextFont	Personnalise l'apparence du texte avec un objet Font, en définissant la famille et la taille de la police en points.	text.Style.TextFont = new Font() { FontFamily = "Calibri", FontSize = 24 };
Color	Définit la couleur du texte à l'aide de couleurs prédéfinies à partir de IronWord.Models.Color ou de valeurs hexagonales personnalisées.	text.Style.Color = IronWord.Models.Color.Red;
IsBold	Permet de mettre le texte en gras lorsqu'il est défini sur true , couramment utilisé pour les titres ou pour mettre l'accent.	text.Style.IsBold = true;
IsItalic	Applique le style italique au texte lorsque la valeur est définie sur true , généralement utilisé pour mettre en valeur un élément important ou pour les titres.	text.Style.IsItalic = true;
Souligner	Ajoute un soulignement au texte en utilisant un objet Souligner avec différents styles de soulignement.	text.Style.Underline = new Underline();
Strike	Applique le barré au texte en utilisant StrikeValue enum (Strike ou DoubleStrike).	text.Style.Strike = StrikeValue.Strike;
Caps	Applique les effets de capitalisation au texte, en convertissant tous les caractères en majuscules.	text.Style.Caps = true;
CharacterScale	Ajuste la largeur proportionnelle des caractères en pourcentage de leur taille normale.	text.Style.CharacterScale = 150;
Emboss	Applique un effet de gaufrage au texte, créant un aspect en relief.	text.Style.Emboss = true;
Accentuation	Ajoute des marques d'accentuation au texte stylisé en utilisant les valeurs de l'enum EmphasisMarkValues.	text.Style.Emphasis = EmphasisMarkValues.Dot;
Espacement des lignes	Contrôle l'espacement entre les lignes de texte pour améliorer la lisibilité à l'aide d'un objet Espacement des lignes.	text.Style.LineSpacing = new LineSpacing() { Value = 1.5 };
Outline	Rend le texte avec un effet de contour, n'affichant que les bordures des caractères.	text.Style.Outline = true;
Ombre	Applique une couleur d'arrière-plan ou un ombrage au texte à l'aide d'un objet Ombre.	text.Style.Shading = new Shading() { Color = Color.Yellow };
SmallCaps	Convertit les minuscules en petites capitales tout en conservant la distinction entre les majuscules et les minuscules.	text.Style.SmallCaps = true;
Position verticale	Ajuste le placement vertical du texte par rapport à sa ligne de base, mesurée en points.	text.Style.VerticalPosition = 5.0;
Alignement vertical du texte	Positionne le texte verticalement dans son conteneur en utilisant VerticalPositionValues enum.	text.Style.VerticalTextAlignment = VerticalPositionValues.Superscript;

### Combinaison de plusieurs styles La puissance de stylisation de texte d'IronWord provient de la combinaison de plusieurs propriétés pour obtenir un formatage complexe. Voici un exemple démontrant un texte stylé de manière professionnelle en combinant diverses propriétés de style : ```csharp using IronWord; using IronWord.Models; // Create a new document WordDocument doc = new WordDocument(); // Create richly formatted text TextContent headerText = new TextContent("Professional Document Header"); headerText.Style = new TextStyle() { TextFont = new Font() { FontFamily = "Georgia", FontSize = 28 }, Color = Color.DarkBlue, IsBold = true, SmallCaps = true, Underline = new Underline(), CharacterScale = 110, // Slightly expand character width Shading = new Shading() { Color = Color.LightGray // Light background } }; // Add header to document Paragraph headerParagraph = new Paragraph(); headerParagraph.AddText(headerText); doc.AddParagraph(headerParagraph); // Create body text with different styling TextContent bodyText = new TextContent("This is professionally formatted body text with custom styling."); bodyText.Style = new TextStyle() { TextFont = new Font() { FontFamily = "Calibri", FontSize = 11 }, Color = Color.Black, LineSpacing = new LineSpacing() { Value = 1.15 } // Slightly increased line spacing }; Paragraph bodyParagraph = new Paragraph(); bodyParagraph.AddText(bodyText); doc.AddParagraph(bodyParagraph); // Save the document doc.SaveAs("professional-document.docx"); ``` Cette approche stylistique complète permet de créer des documents conservant une image de marque cohérente et une apparence professionnelle tout au long du processus de génération de documents de votre application.