Style
Contenu
[
Cacher
]Style class
Représente un seul style intégré ou défini par l’utilisateur.
Pour en savoir plus, visitez leTravailler avec des styles et des thèmes article documentaire.
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 de chaînes vide est renvoyé. |
| AutomaticallyUpdate { get; set; } | Spécifie si ce style est automatiquement redéfini en fonction de la valeur appropriée. |
| BaseStyleName { get; set; } | Obtient/définit le nom du style sur lequel ce style est basé. |
| BuiltIn { get; } | True si ce style est l’un des styles intégrés dans MS Word. |
| Document { get; } | Obtient le document propriétaire. |
| Font { get; } | Obtient le formatage 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; } | Obtient le nom duStyle 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; } | Permet d’accéder 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’identifiant de style indépendant des paramètres régionaux pour un style intégré. |
| Styles { get; } | Obtient la collection de styles à laquelle appartient ce style. |
| Type { get; } | Obtient le type de style (paragraphe ou caractère). |
Méthodes
| Nom | La description |
|---|---|
| Equals(Style) | Se compare au 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 du 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;
// Applique le style de paragraphe au paragraphe actuel du générateur de documents, puis ajoute du texte.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");
// Changez le style du générateur de documents en un style sans 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;
// Redéfinit automatiquement le style.
style.AutomaticallyUpdate = true;
DocumentBuilder builder = new DocumentBuilder(doc);
// Applique l'un des styles du document au paragraphe créé par le générateur de document.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");
Style firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;
Assert.AreEqual(style, firstParagraphStyle);
// Supprimez notre style personnalisé de la collection de styles du document.
doc.Styles["MyStyle"].Remove();
firstParagraphStyle = doc.FirstSection.Body.FirstParagraph.ParagraphFormat.Style;
// Tout texte utilisant 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
- espace de noms Aspose.Words
- Assemblée Aspose.Words
