Style

Style class

Representerar en enda inbyggd eller användardefinierad stil.

För att lära dig mer, besökArbeta med stilar och teman dokumentationsartikel.

public class Style

Egenskaper

namnBeskrivning
Aliases { get; }Hämtar alla alias för denna stil. Om stilen inte har några alias returneras en tom array med sträng.
AutomaticallyUpdate { get; set; }Anger om den här stilen automatiskt omdefinieras baserat på lämpligt värde.
BaseStyleName { get; set; }Hämtar/ställer in namnet på stilen som stilen är baserad på.
BuiltIn { get; }Sant om den här stilen är en av de inbyggda stilarna i MS Word.
Document { get; }Hämtar ägardokumentet.
Font { get; }Hämtar teckenformateringen för stilen.
IsHeading { get; }Sant när stilen är en av de inbyggda rubrikstilarna.
IsQuickStyle { get; set; }Anger om den här stilen visas i snabbstilsgalleriet i MS Words användargränssnitt.
LinkedStyleName { get; set; }Hämtar/ställer in namnet påStyle länkad till denna. Returnerar en tom sträng om inga stilar är länkade.
List { get; }Hämtar listan som definierar formateringen av denna liststil.
ListFormat { get; }Ger åtkomst till listformateringsegenskaperna för ett styckeformat.
Locked { get; set; }Anger om den här stilen är låst.
Name { get; set; }Hämtar eller anger namnet på stilen.
NextParagraphStyleName { get; set; }Hämtar/ställer in namnet på den stil som ska tillämpas automatiskt på ett nytt stycke som infogas efter ett stycke formaterat med den angivna stilen.
ParagraphFormat { get; }Hämtar styckeformateringen för stilen.
Priority { get; set; }Hämtar/ställer in heltalsvärdet som representerar prioriteten för sortering av formaten i åtgärdsfönstret Format.
SemiHidden { get; set; }Hämtar/ställer in om stilen ska döljas från stilgalleriet och från åtgärdsfönstret Stilar.
StyleIdentifier { get; }Hämtar den språkoberoende stilidentifieraren för en inbyggd stil.
Styles { get; }Hämtar samlingen av stilar som den här stilen tillhör.
Type { get; }Hämtar formateringstypen (stycke eller tecken).
UnhideWhenUsed { get; set; }Hämtar/ställer in om stilen som används i det aktuella dokumentet ska visas i stilgalleriet och i åtgärdsfönstret Stilar. Sant när den använda stilen ska visas i stilgalleriet.

Metoder

namnBeskrivning
Equals(Style)Jämförs med den angivna stilen. Stilar ISTD jämförs endast för inbyggda stilar. Standardinställningar för stilar ingår inte i jämförelsen. Basstil, länkad stil och stil för nästa stycke jämförs rekursivt.
Remove()Tar bort den angivna stilen från dokumentet.

Exempel

Visar hur man skapar och använder ett styckeformat med listformatering.

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

// Skapa ett anpassat styckeformat.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// Skapa en lista och se till att stycken som använder den här stilen kommer att använda den här listan.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// Använd styckeformatet på dokumentbyggarens aktuella stycke och lägg sedan till lite text.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// Ändra dokumentbyggarens stil till en som inte har någon listformatering och skriv ett annat stycke.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

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

Visar hur man skapar och tillämpar en anpassad stil.

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;
// Omdefiniera stil automatiskt.
style.AutomaticallyUpdate = true;

DocumentBuilder builder = new DocumentBuilder(doc);

// Använd en av formaten från dokumentet på stycket som dokumentbyggaren skapar.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

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

Assert.AreEqual(style, firstParagraphStyle);

// Ta bort vår anpassade stil från dokumentets stilsamling.
doc.Styles["MyStyle"].Remove();

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

// All text som använde en borttagen stil återgår till standardformateringen.
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());

Se även