DoNotTrackFormatting Class
Do Not Track Formatting Revisions When Tracking Revisions.When the object is serialized out as xml, its qualified name is w:doNotTrackFormatting.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlLeafElement
DocumentFormat.OpenXml.Wordprocessing.OnOffType
DocumentFormat.OpenXml.Wordprocessing.DoNotTrackFormatting
Namespace: DocumentFormat.OpenXml.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
Public Class DoNotTrackFormatting _
Inherits OnOffType
'Usage
Dim instance As DoNotTrackFormatting
public class DoNotTrackFormatting : OnOffType
Remarks
[ISO/IEC 29500-1 1st Edition]
17.15.1.40 doNotTrackFormatting (Do Not Track Formatting Revisions When Tracking Revisions)
This element specifies that applications shall not track revisions made to the formatting of this WordprocessingML document when the trackRevisions element (§17.15.1.89) is turned on.
If this element is omitted, then revisions to formatting shall be generated by changes to the contents of this document when the trackRevisions element is turned on.
[Example: Consider a WordprocessingML document containing the text run Example that must have revisions tracked. Example WordprocessingML from Document 1 is given below:
<w:document> <w:body> <w:p> <w:r> <w:t>Example</w:t> </w:r> </w:p> </w:body> </w:document>
If the word text was added to the end of this document and bolded, the resulting WordprocessingML would be output as follows:
<w:document> <w:body> <w:p> <w:r> <w:t>Example</w:t> </w:r> <w:ins … > <w:r> <w:rPr> <w:b/> <w:rPrChange … > <w:rPr/> </w:rPrChange> </w:rPr> <w:t>text</w:t> </w:r> </w:ins> </w:p> </w:body> </w:document>
If changes to formatting were turned off using the following WordprocessingML syntax in the document settings:
<w:settings> <w:trackRevisions w:val="true" /> <w:doNotTrackFormatting w:val="true" /> … </w:settings>
The same revision (the word text was added to the end of this document and bolded) would result in the following markup:
<w:document> <w:body> <w:p> <w:r> <w:t>Example</w:t> </w:r> <w:ins … > <w:r> <w:rPr> <w:b/> </w:rPr> <w:t>text</w:t> </w:r> </w:ins> </w:p> </w:body> </w:document>
The doNotTrackFormatting element's val attribute was set to true, therefore the changes to the formatting of the document were not tracked as revisions in the document's WordprocessingML. Specifically, applying bold formatting to the text was not tracked as a revision with the rPrChange (§17.13.5.31) element. end example]
Parent Elements |
|---|
settings (§17.15.1.78) |
This element’s content model is defined by the common boolean property definition in §17.17.4.
© ISO/IEC29500: 2008.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.