AddCopy

StyleCollection.AddCopy method

Kopiert einen Stil in diese Sammlung.

public Style AddCopy(Style style)
ParameterTypBeschreibung
styleStyleZu kopierender Stil.

Rückgabewert

Kopierter Stil zur Verwendung bereit.

Bemerkungen

Der zu kopierende Stil kann sowohl zum selben Dokument als auch zu einem anderen Dokument gehören.

Der verknüpfte Stil wird kopiert.

Diese Methode kopiert keine Basisstile.

Wenn die Sammlung bereits einen Stil mit demselben Namen enthält, wird automatisch ein neuer Name generiert, indem das Suffix „_Nummer“ hinzugefügt wird, das bei 0 beginnt, z. B. „Normal_0“, „Überschrift 1_1“ usw. VerwendungName Setter zum Ändern des Namens des importierten Stils.

Beispiele

Zeigt, wie ein Stil aus einem Dokument in ein anderes Dokument importiert wird.

Document srcDoc = new Document();

// Einen benutzerdefinierten Stil für das Quelldokument erstellen.
Style srcStyle = srcDoc.Styles.Add(StyleType.Paragraph, "MyStyle");
srcStyle.Font.Color = Color.Red;

// Den benutzerdefinierten Stil des Quelldokuments in das Zieldokument importieren.
Document dstDoc = new Document();
Style newStyle = dstDoc.Styles.AddCopy(srcStyle);

// Der importierte Stil sieht genauso aus wie sein Quellstil.
Assert.AreEqual("MyStyle", newStyle.Name);
Assert.AreEqual(Color.Red.ToArgb(), newStyle.Font.Color.ToArgb());

Zeigt, wie der Stil eines Dokuments geklont wird.

Document doc = new Document();

// Die AddCopy-Methode erstellt eine Kopie des angegebenen Stils und
// generiert automatisch einen neuen Namen für den Stil, z. B. „Überschrift 1_0“.
Style newStyle = doc.Styles.AddCopy(doc.Styles["Heading 1"]);

// Verwenden Sie die Eigenschaft „Name“ des Stils, um den identifizierenden Namen des Stils zu ändern.
newStyle.Name = "My Heading 1";

// Unser Dokument hat jetzt zwei identisch aussehende Stile mit unterschiedlichen Namen.
// Das Ändern der Einstellungen eines Stils hat keinen Einfluss auf den anderen.
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);

Siehe auch

StyleCollection.Add StyleCollection.ClearQuickStyleGallery