Style

Style class

Représente un seul style intégré ou défini par l’utilisateur.

public class Style

Propriétés

Nom La description
Aliases { get; } Obtient tous les alias de ce style. Si le style n’a pas d’alias, un tableau vide de chaînes est renvoyé.
BaseStyleName { get; set; } Obtient/définit le nom du style sur lequel ce style est basé.
BuiltIn { get; } Vrai si ce style est l’un des styles intégrés dans MS Word.
Document { get; } Obtient le document propriétaire.
Font { get; } Obtient la mise en forme des caractères du style.
IsHeading { get; } Vrai lorsque le style est l’un des styles de titre intégrés.
IsQuickStyle { get; set; } Spécifie si ce style est affiché dans la galerie de styles rapides dans l’interface utilisateur de MS Word.
LinkedStyleName { get; } Récupère le nom du Style lié à celui-ci. Renvoie une chaîne vide si aucun style n’est lié.
List { get; } Obtient la liste qui définit le formatage de ce style de liste.
ListFormat { get; } Fournit l’accès aux propriétés de formatage de liste d’un style de paragraphe.
Name { get; set; } Obtient ou définit le nom du style.
NextParagraphStyleName { get; set; } Obtient/définit le nom du style à appliquer automatiquement à un nouveau paragraphe inséré après un paragraphe formaté avec le style spécifié.
ParagraphFormat { get; } Obtient la mise en forme du paragraphe du style.
StyleIdentifier { get; } Obtient l’identificateur de style indépendant des paramètres régionaux pour un style intégré.
Styles { get; } Obtient la collection de styles à laquelle ce style appartient.
Type { get; } Obtient le type de style (paragraphe ou caractère).

Méthodes

Nom La description
Equals(Style) Compare avec le style spécifié. Les styles Istds sont comparés uniquement pour les styles intégrés. Les styles par défaut ne sont pas inclus dans la comparaison. Le style de base, le style lié et le style de paragraphe suivant sont comparés de manière récursive.
Remove() Supprime le style spécifié du document.

Exemples

Montre comment créer et utiliser un style de paragraphe avec une mise en forme de liste.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Crée un style de paragraphe personnalisé.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// Créez une liste et assurez-vous que les paragraphes qui utilisent ce style utiliseront cette liste.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// Appliquez le style de paragraphe au paragraphe actuel du générateur de document, puis ajoutez du texte.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// Modifiez le style du générateur de document en un style qui n'a pas de formatage de liste et écrivez un autre paragraphe.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

builder.Document.Save(ArtifactsDir + "Styles.ParagraphStyleBulletedList.docx");

Montre comment créer et appliquer un style personnalisé.

Document doc = new Document();

Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle");
style.Font.Name = "Times New Roman";
style.Font.Size = 16;
style.Font.Color = Color.Navy;

DocumentBuilder builder = new DocumentBuilder(doc);

// Appliquez l'un des styles du document au paragraphe que le générateur de document est en train de créer.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

Style firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;

Assert.AreEqual(style, firstParagraphStyle);

// Supprime notre style personnalisé de la collection de styles du document.
doc.Styles["MyStyle"].Remove();

firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;

// Tout texte qui utilisait un style supprimé revient au formatage par défaut.
Assert.False(doc.Styles.Any(s => s.Name == "MyStyle"));
Assert.AreEqual("Times New Roman", firstParagraphStyle.Font.Name);
Assert.AreEqual(12.0d, firstParagraphStyle.Font.Size);
Assert.AreEqual(Color.Empty.ToArgb(), firstParagraphStyle.Font.Color.ToArgb());

Voir également