Style

Style class

Rappresenta un singolo stile integrato o definito dall’utente.

public class Style

Proprietà

Nome Descrizione
Aliases { get; } Ottiene tutti gli alias di questo stile. Se lo stile non ha alias, viene restituito un array di stringhe vuoto.
BaseStyleName { get; set; } Ottiene/imposta il nome dello stile su cui si basa questo stile.
BuiltIn { get; } Vero se questo stile è uno degli stili incorporati in MS Word.
Document { get; } Ottiene il documento proprietario.
Font { get; } Ottiene la formattazione dei caratteri dello stile.
IsHeading { get; } Vero quando lo stile è uno degli stili di intestazione incorporati.
IsQuickStyle { get; set; } Specifica se questo stile viene visualizzato nella raccolta Stili rapidi all’interno dell’interfaccia utente di MS Word.
LinkedStyleName { get; } Ottiene il nome dello stile collegato a questo. Restituisce una stringa vuota se nessuno stile è collegato.
List { get; } Ottiene l’elenco che definisce la formattazione di questo stile di elenco.
ListFormat { get; } Fornisce l’accesso alle proprietà di formattazione dell’elenco di uno stile di paragrafo.
Name { get; set; } Ottiene o imposta il nome dello stile.
NextParagraphStyleName { get; set; } Ottiene/imposta il nome dello stile da applicare automaticamente a un nuovo paragrafo inserito dopo un paragrafo formattato con lo stile specificato.
ParagraphFormat { get; } Ottiene la formattazione del paragrafo dello stile.
StyleIdentifier { get; } Ottiene l’identificatore di stile indipendente dalla locale per uno stile integrato.
Styles { get; } Ottiene la raccolta di stili a cui appartiene questo stile.
Type { get; } Ottiene il tipo di stile (paragrafo o carattere).

Metodi

Nome Descrizione
Equals(Style) Confronta con lo stile specificato. Gli stili Istd vengono confrontati solo per gli stili incorporati. Gli stili predefiniti non sono inclusi nel confronto. Lo stile di base, lo stile collegato e lo stile di paragrafo successivo vengono confrontati in modo ricorsivo.
Remove() Rimuove lo stile specificato dal documento.

Esempi

Mostra come creare e utilizzare uno stile di paragrafo con la formattazione dell’elenco.

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

// Crea uno stile di paragrafo personalizzato.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// Crea un elenco e assicurati che i paragrafi che utilizzano questo stile utilizzeranno questo elenco.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// Applica lo stile di paragrafo al paragrafo corrente del generatore di documenti, quindi aggiungi del testo.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// Cambia lo stile del generatore di documenti in uno che non ha formattazione dell'elenco e scrivi un altro paragrafo.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

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

Mostra come creare e applicare uno stile personalizzato.

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);

// Applica uno degli stili dal documento al paragrafo che sta creando il generatore di documenti.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

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

Assert.AreEqual(style, firstParagraphStyle);

// Rimuovi il nostro stile personalizzato dalla raccolta di stili del documento.
doc.Styles["MyStyle"].Remove();

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

// Qualsiasi testo che utilizzava uno stile rimosso ripristina la formattazione predefinita.
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());

Guarda anche