Style

Style class

Representa un único estilo integrado o definido por el usuario.

public class Style

Propiedades

Nombre Descripción
Aliases { get; } Obtiene todos los alias de este estilo. Si el estilo no tiene alias, se devuelve una matriz vacía de cadena.
BaseStyleName { get; set; } Obtiene/establece el nombre del estilo en el que se basa este estilo.
BuiltIn { get; } Verdadero si este estilo es uno de los estilos incorporados en MS Word.
Document { get; } Obtiene el documento del propietario.
Font { get; } Obtiene el formato de caracteres del estilo.
IsHeading { get; } Verdadero cuando el estilo es uno de los estilos de encabezado integrados.
IsQuickStyle { get; set; } Especifica si este estilo se muestra en la galería Estilo rápido dentro de la interfaz de usuario de MS Word.
LinkedStyleName { get; } Obtiene el nombre del Estilo vinculado a este. Devuelve una cadena vacía si no hay estilos vinculados.
List { get; } Obtiene la lista que define el formato de este estilo de lista.
ListFormat { get; } Proporciona acceso a las propiedades de formato de lista de un estilo de párrafo.
Name { get; set; } Obtiene o establece el nombre del estilo.
NextParagraphStyleName { get; set; } Obtiene/establece el nombre del estilo que se aplicará automáticamente a un nuevo párrafo insertado después de un párrafo formateado con el estilo especificado.
ParagraphFormat { get; } Obtiene el formato de párrafo del estilo.
StyleIdentifier { get; } Obtiene el identificador de estilo independiente de la configuración regional para un estilo integrado.
Styles { get; } Obtiene la colección de estilos a la que pertenece este estilo.
Type { get; } Obtiene el tipo de estilo (párrafo o carácter).

Métodos

Nombre Descripción
Equals(Style) Compara con el estilo especificado. Las listas de estilos se comparan solo para los estilos integrados. Los estilos predeterminados no se incluyen en la comparación. El estilo base, el estilo vinculado y el estilo del siguiente párrafo se comparan recursivamente.
Remove() Elimina el estilo especificado del documento.

Ejemplos

Muestra cómo crear y utilizar un estilo de párrafo con formato de lista.

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

// Crea un estilo de párrafo personalizado.
Style style = doc.Styles.Add(StyleType.Paragraph, "MyStyle1");
style.Font.Size = 24;
style.Font.Name = "Verdana";
style.ParagraphFormat.SpaceAfter = 12;

// Cree una lista y asegúrese de que los párrafos que usan este estilo usen esta lista.
style.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);
style.ListFormat.ListLevelNumber = 0;

// Aplique el estilo de párrafo al párrafo actual del generador de documentos y luego agregue algo de texto.
builder.ParagraphFormat.Style = style;
builder.Writeln("Hello World: MyStyle1, bulleted list.");

// Cambie el estilo del generador de documentos a uno que no tenga formato de lista y escriba otro párrafo.
builder.ParagraphFormat.Style = doc.Styles["Normal"];
builder.Writeln("Hello World: Normal.");

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

Muestra cómo crear y aplicar un estilo personalizado.

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

// Aplicar uno de los estilos del documento al párrafo que está creando el generador de documentos.
builder.ParagraphFormat.Style = doc.Styles["MyStyle"];
builder.Writeln("Hello world!");

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

Assert.AreEqual(style, firstParagraphStyle);

// Eliminar nuestro estilo personalizado de la colección de estilos del documento.
doc.Styles["MyStyle"].Remove();

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

// Cualquier texto que usó un estilo eliminado vuelve al formato predeterminado.
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());

Ver también