CoAuthUpdate Object (Word)

Represents a range of text that has been updated by a co-author.

Version Information

Version Added: Word 2010

Remarks

When a document with co-authoring enabled is edited by more than one author, changes to the document by one author are pushed to other authors’ versions of the document using updates. When a co-author performs an explicit document save (by pressing CTRL + S, for example), changes made by other co-authors are merged into the document as updates. The CoAuthUpdates collection contains all changes that were merged into the document, where each change is a single update represented by a CoAuthUpdate object.

The contents of the CoAuthUpdates collection remains the same until a co-author performs another explicit document save. When the co-author saves the document again, if there are no new changes from other co-authors that are merged into the document, the CoAuthUpdates collection retains the same updates that were merged at the previous explicit save. If there are new changes that are merged into the document, the CoAuthUpdates collection contains the new updates for the document. Use a CoAuthUpdate object to retrieve an individual update from the CoAuthUpdates collection.

Example

The following code example gets the associated text in the range of each CoAuthUpdate object in the active document.

Dim caUpdate As CoAuthUpdate 
Dim strText As String 
 
For Each caUpdate In ActiveDocument.CoAuthoring.Updates 
    strText = caUpdate.Range.Text 
    MsgBox strText 
Next caUpdate

See Also

Concepts

Word Object Model Reference

CoAuthUpdate Object Members