Style

Style class

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

Para obtener más información, visite elTrabajar con estilos y temas Artículo de documentación.

public class Style

Propiedades

NombreDescripción
Aliases { get; }Obtiene todos los alias de este estilo. Si el estilo no tiene alias, se devuelve una matriz de cadenas vacía.
AutomaticallyUpdate { get; set; }Especifica si este estilo se redefine automáticamente en función del valor apropiado.
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 integrados en MS Word.
Document { get; }Obtiene el documento del propietario.
Font { get; }Obtiene el formato de carácter del estilo.
IsHeading { get; }Verdadero cuando el estilo es uno de los estilos de título integrados.
IsQuickStyle { get; set; }Especifica si este estilo se muestra en la galería de estilos rápidos dentro de la interfaz de usuario de MS Word.
LinkedStyleName { get; set; }Obtiene/establece el nombre delStyle 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.
Locked { get; set; }Especifica si este estilo está bloqueado.
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.
Priority { get; set; }Obtiene/establece el valor entero que representa la prioridad para ordenar los estilos en el panel de tareas Estilos.
SemiHidden { get; set; }Obtiene/establece si el estilo se oculta en la galería de Estilos y en el panel de tareas Estilos.
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).
UnhideWhenUsed { get; set; }Obtiene/establece si el estilo usado en el documento actual se muestra en la galería de Estilos y en el panel de tareas Estilos. Verdadero cuando el estilo usado debe mostrarse en la galería de Estilos.

Métodos

NombreDescripción
Equals(Style)Se compara con el estilo especificado. Los estilos predeterminados se comparan solo para 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 de forma recursiva.
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 usarán 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;
// Redefinir el estilo automáticamente.
style.AutomaticallyUpdate = true;

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

//Elimina 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 utilice 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

StoryType Enum StyleCollection Class