is_insert_revision property

InlineStory.is_insert_revision property

Returns true if this object was inserted in Microsoft Word while change tracking was enabled.

@property
def is_insert_revision(self) -> bool:
    ...

Examples

Shows how to view revision-related properties of InlineStory nodes.

doc = aw.Document(file_name=MY_DIR + 'Revision footnotes.docx')
# When we edit the document while the "Track Changes" option, found in via Review -> Tracking,
# is turned on in Microsoft Word, the changes we apply count as revisions.
# When editing a document using Aspose.Words, we can begin tracking revisions by
# invoking the document's "StartTrackRevisions" method and stop tracking by using the "StopTrackRevisions" method.
# We can either accept revisions to assimilate them into the document
# or reject them to undo and discard the proposed change.
self.assertTrue(doc.has_revisions)
footnotes = [x.as_footnote() for x in list(doc.get_child_nodes(aw.NodeType.FOOTNOTE, True)) if isinstance(x.as_footnote(), aw.notes.Footnote)]
self.assertEqual(5, len(footnotes))
# Below are five types of revisions that can flag an InlineStory node.
# 1 -  An "insert" revision:
# This revision occurs when we insert text while tracking changes.
self.assertTrue(footnotes[2].is_insert_revision)
# 2 -  A "move from" revision:
# When we highlight text in Microsoft Word, and then drag it to a different place in the document
# while tracking changes, two revisions appear.
# The "move from" revision is a copy of the text originally before we moved it.
self.assertTrue(footnotes[4].is_move_from_revision)
# 3 -  A "move to" revision:
# The "move to" revision is the text that we moved in its new position in the document.
# "Move from" and "move to" revisions appear in pairs for every move revision we carry out.
# Accepting a move revision deletes the "move from" revision and its text,
# and keeps the text from the "move to" revision.
# Rejecting a move revision conversely keeps the "move from" revision and deletes the "move to" revision.
self.assertTrue(footnotes[1].is_move_to_revision)
# 4 -  A "delete" revision:
# This revision occurs when we delete text while tracking changes. When we delete text like this,
# it will stay in the document as a revision until we either accept the revision,
# which will delete the text for good, or reject the revision, which will keep the text we deleted where it was.
self.assertTrue(footnotes[3].is_delete_revision)

See Also

InlineStory.is_delete_revision property InlineStory.is_move_from_revision property