Style

Style class

Stellt einen einzelnen integrierten oder benutzerdefinierten Stil dar.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Stilen und Designs Dokumentationsartikel.

public class Style

Eigenschaften

NameBeschreibung
Aliases { get; }Ruft alle Aliase dieses Stils ab. Wenn der Stil keine Aliase hat, wird ein leeres Array von Zeichenfolgen zurückgegeben.
AutomaticallyUpdate { get; set; }Gibt an, ob dieser Stil basierend auf dem entsprechenden Wert automatisch neu definiert wird.
BaseStyleName { get; set; }Ruft den Namen des Stils ab/legt ihn fest, auf dem dieser Stil basiert.
BuiltIn { get; }Wahr, wenn dieser Stil einer der integrierten Stile in MS Word ist.
Document { get; }Ruft das Besitzerdokument ab.
Font { get; }Ruft die Zeichenformatierung des Stils ab.
IsHeading { get; }Wahr, wenn der Stil einer der integrierten Überschriftenstile ist.
IsQuickStyle { get; set; }Gibt an, ob dieser Stil in der Quick Style-Galerie in der MS Word-Benutzeroberfläche angezeigt wird.
LinkedStyleName { get; set; }Ruft den Namen desStyle mit diesem verknüpft. Gibt einen leeren String zurück, wenn keine Stile verknüpft sind.
List { get; }Ruft die Liste ab, die die Formatierung dieses Listenstils definiert.
ListFormat { get; }Bietet Zugriff auf die Listenformatierungseigenschaften eines Absatzstils.
Locked { get; set; }Gibt an, ob dieser Stil gesperrt ist.
Name { get; set; }Ruft den Namen des Stils ab oder legt ihn fest.
NextParagraphStyleName { get; set; }Ruft den Namen des Stils ab bzw. legt ihn fest, der automatisch auf einen neuen Absatz angewendet werden soll, der nach einem Absatz eingefügt wird, der mit dem angegebenen Stil formatiert ist.
ParagraphFormat { get; }Ruft die Absatzformatierung des Stils ab.
Priority { get; set; }Ruft den ganzzahligen Wert ab bzw. legt ihn fest, der die Priorität für die Sortierung der Stile im Aufgabenbereich „Stile“ darstellt.
SemiHidden { get; set; }Ruft ab/legt fest, ob der Stil in der Stilgalerie und im Aufgabenbereich „Stile“ ausgeblendet wird.
StyleIdentifier { get; }Ruft die gebietsschemaunabhängige Stilkennung für einen integrierten Stil ab.
Styles { get; }Ruft die Sammlung von Stilen ab, zu denen dieser Stil gehört.
Type { get; }Ruft den Stiltyp (Absatz oder Zeichen) ab.
UnhideWhenUsed { get; set; }Ruft ab/legt fest, ob der im aktuellen Dokument verwendete Stil aus der Stilgalerie und dem Aufgabenbereich „Stile“ eingeblendet wird. „True“, wenn der verwendete Stil in der Stilgalerie angezeigt werden soll.

Methoden

NameBeschreibung
Equals(Style)Vergleicht mit dem angegebenen Stil. Stil-Istds werden nur für integrierte Stile verglichen. Stil-Standards werden nicht in den Vergleich einbezogen. Basisstil, verknüpfter Stil und nächster Absatzstil werden rekursiv verglichen.
Remove()Entfernt den angegebenen Stil aus dem Dokument.

Beispiele

Zeigt, wie ein Absatzstil mit Listenformatierung erstellt und verwendet wird.

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

// Erstellen Sie einen benutzerdefinierten Absatzstil.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// Erstellen Sie eine Liste und stellen Sie sicher, dass die Absätze, die diesen Stil verwenden, diese Liste verwenden.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// Wenden Sie den Absatzstil auf den aktuellen Absatz des Dokumentgenerators an und fügen Sie dann etwas Text hinzu.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// Ändern Sie den Stil des Dokument-Generators in einen Stil ohne Listenformatierung und schreiben Sie einen weiteren Absatz.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

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

Zeigt, wie ein benutzerdefinierter Stil erstellt und angewendet wird.

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;
// Stil automatisch neu definieren.
style.AutomaticallyUpdate = true;

DocumentBuilder builder = new DocumentBuilder(doc);

// Wenden Sie einen der Stile aus dem Dokument auf den Absatz an, den der Dokumentgenerator erstellt.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

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

Assert.AreEqual(style, firstParagraphStyle);

// Entfernen Sie unseren benutzerdefinierten Stil aus der Stilsammlung des Dokuments.
doc.Styles["MyStyle"].Remove();

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

// Jeder Text, der einen entfernten Stil verwendet hat, wird auf die Standardformatierung zurückgesetzt.
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());

Siehe auch

StoryType Enum StyleCollection Class