AddCopy

StyleCollection.AddCopy method

Copie un style dans cette collection.

public Style AddCopy(Style style)
ParamètreTaperLa description
styleStyleStyle à copier.

Return_Value

Style copié prêt à l’emploi.

Remarques

Le style à copier peut appartenir au même document ainsi qu’à des documents différents.

Le style lié est copié.

Cette méthode ne copie pas les styles de base.

Si la collection contient déjà un style avec le même nom, alors le nouveau nom est automatiquement généré en ajoutant le suffixe “_number” commençant à 0, par exemple “Normal_0”, “Titre 1_1”, etc. UtilisationName setter pour changer le nom du style importé.

Exemples

Montre comment importer un style d’un document vers un autre document.

Document srcDoc = new Document();

// Crée un style personnalisé pour le document source.
Style srcStyle = srcDoc.Styles.Add(StyleType.Paragraph, "MyStyle");
srcStyle.Font.Color = Color.Red;

// Importez le style personnalisé du document source dans le document de destination.
Document dstDoc = new Document();
Style newStyle = dstDoc.Styles.AddCopy(srcStyle);

// Le style importé a une apparence identique à son style source.
Assert.AreEqual("MyStyle", newStyle.Name);
Assert.AreEqual(Color.Red.ToArgb(), newStyle.Font.Color.ToArgb());

Montre comment cloner le style d’un document.

Document doc = new Document();

// La méthode AddCopy crée une copie du style spécifié et
// génère automatiquement un nouveau nom pour le style, tel que "Titre 1_0".
Style newStyle = doc.Styles.AddCopy(doc.Styles["Heading 1"]);

// Utilisez la propriété "Name" du style pour modifier le nom d'identification du style.
newStyle.Name = "My Heading 1";

// Notre document a maintenant deux styles identiques avec des noms différents.
// La modification des paramètres de l'un des styles n'affecte pas l'autre.
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);

Voir également