public void RevisionCollection()
{
//ExStart
//ExFor:Revision.ParentStyle
//ExFor:RevisionCollection.GetEnumerator
//ExFor:RevisionCollection.Groups
//ExFor:RevisionCollection.RejectAll
//ExFor:RevisionGroupCollection.GetEnumerator
//ExSummary:Shows how to work with a document's collection of revisions.
Document doc = new Document(MyDir + "Revisions.docx");
RevisionCollection revisions = doc.Revisions;
// This collection itself has a collection of revision groups.
// Each group is a sequence of adjacent revisions.
Assert.AreEqual(7, revisions.Groups.Count); //ExSkip
Console.WriteLine($"{revisions.Groups.Count} revision groups:");
// Iterate over the collection of groups and print the text that the revision concerns.
using (IEnumerator <RevisionGroup> e = revisions.Groups.GetEnumerator())
{
while (e.MoveNext())
{
Console.WriteLine($"\tGroup type \"{e.Current.RevisionType}\", " +
$"author: {e.Current.Author}, contents: [{e.Current.Text.Trim()}]");
}
}
// Each Run that a revision affects gets a corresponding Revision object.
// The revisions' collection is considerably larger than the condensed form we printed above,
// depending on how many Runs we have segmented the document into during Microsoft Word editing.
Assert.AreEqual(11, revisions.Count); //ExSkip
Console.WriteLine($"\n{revisions.Count} revisions:");
using (IEnumerator <Revision> e = revisions.GetEnumerator())
{
while (e.MoveNext())
{
// A StyleDefinitionChange strictly affects styles and not document nodes. This means the "ParentStyle"
// property will always be in use, while the ParentNode will always be null.
// Since all other changes affect nodes, ParentNode will conversely be in use, and ParentStyle will be null.
if (e.Current.RevisionType == RevisionType.StyleDefinitionChange)
{
Console.WriteLine($"\tRevision type \"{e.Current.RevisionType}\", " +
$"author: {e.Current.Author}, style: [{e.Current.ParentStyle.Name}]");
}
else
{
Console.WriteLine($"\tRevision type \"{e.Current.RevisionType}\", " +
$"author: {e.Current.Author}, contents: [{e.Current.ParentNode.GetText().Trim()}]");
}
}
}
// Reject all revisions via the collection, reverting the document to its original form.
revisions.RejectAll();
Assert.AreEqual(0, revisions.Count);
//ExEnd
}
