AddCopy

StyleCollection.AddCopy method

Copia un estilo en esta colección.

public Style AddCopy(Style style)
ParámetroEscribeDescripción
styleStyleEstilo a copiar.

Valor_devuelto

Estilo copiado listo para usar.

Observaciones

El estilo a copiar puede pertenecer tanto al mismo documento como a documentos diferentes.

Se copia el estilo vinculado.

Este método no copia estilos base.

Si la colección ya contiene un estilo con el mismo nombre, entonces el nuevo nombre es se genera automáticamente agregando el sufijo “_number” a partir de 0, por ejemplo, “Normal_0”, “Encabezado 1_1”, etc. UsarName setter para cambiar el nombre del estilo importado.

Ejemplos

Muestra cómo importar un estilo de un documento a otro documento diferente.

Document srcDoc = new Document();

// Crea un estilo personalizado para el documento fuente.
Style srcStyle = srcDoc.Styles.Add(StyleType.Paragraph, "MyStyle");
srcStyle.Font.Color = Color.Red;

// Importa el estilo personalizado del documento de origen al documento de destino.
Document dstDoc = new Document();
Style newStyle = dstDoc.Styles.AddCopy(srcStyle);

// El estilo importado tiene una apariencia idéntica a su estilo de origen.
Assert.AreEqual("MyStyle", newStyle.Name);
Assert.AreEqual(Color.Red.ToArgb(), newStyle.Font.Color.ToArgb());

Muestra cómo clonar el estilo de un documento.

Document doc = new Document();

// El método AddCopy crea una copia del estilo especificado y
// genera automáticamente un nuevo nombre para el estilo, como "Título 1_0".
Style newStyle = doc.Styles.AddCopy(doc.Styles["Heading 1"]);

// Utilice la propiedad "Nombre" del estilo para cambiar el nombre de identificación del estilo.
newStyle.Name = "My Heading 1";

// Nuestro documento ahora tiene dos estilos idénticos con nombres diferentes.
// Cambiar la configuración de uno de los estilos no afecta al otro.
newStyle.Font.Color = Color.Red;

Assert.AreEqual("My Heading 1", newStyle.Name);
Assert.AreEqual("Heading 1", doc.Styles["Heading 1"].Name);

Assert.AreEqual(doc.Styles["Heading 1"].Type, newStyle.Type);
Assert.AreEqual(doc.Styles["Heading 1"].Font.Name, newStyle.Font.Name);
Assert.AreEqual(doc.Styles["Heading 1"].Font.Size, newStyle.Font.Size);
Assert.AreNotEqual(doc.Styles["Heading 1"].Font.Color, newStyle.Font.Color);

Ver también

StyleCollection.Add StyleCollection.ClearQuickStyleGallery