UseSingleBorderForContiguousCells Class

Use Simplified Rules For Table Border Conflicts.When the object is serialized out as xml, its qualified name is w:useSingleBorderforContiguousCells.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.OnOffType
        DocumentFormat.OpenXml.Wordprocessing.UseSingleBorderForContiguousCells

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class UseSingleBorderForContiguousCells _
    Inherits OnOffType
'Usage
Dim instance As UseSingleBorderForContiguousCells
public class UseSingleBorderForContiguousCells : OnOffType

Remarks

[ISO/IEC 29500-1 1st Edition]

9.7.3.53 useSingleBorderforContiguousCells (Use Simplified Rules For Table Border Conflicts)

This element specifies whether applications should use an alternate simplified algorithm when handling conflicts between adjacent table borders within a table.

Typically, the conflicts between two adjacent table borders are handled using the conflict resolution algorithm defined in Part 1, §17.4.39 of ISO/IEC 29500. This element, when present with a val attribute value of true (or equivalent), specifies that rather than using that algorithm to determine the outcome of the conflict to two adjacent borders, that the following logic shall be used instead:

  • Cell borders shall supersede table borders

  • Cell borders to the right shall supersede cell borders to the left (i.e. the rightmost border wins in conflicts between vertical borders)

  • Cell borders below shall supersede cell borders above (i.e. the bottommost border wins in conflicts between horizontal borders)

[Example: Consider a WordprocessingML document with cell and table borders defined as follows. In the image below, 0.1" of padding has been added between each cell temporarily to clearly illustrate the borders on each cell and on the table:

DocumentFormat.OpenXml.Wordprocessing.UseSingleBor

The default presentation would have the border conflicts resolved using the algorithm defined by ISO/IEC 29500, resulting in the following table:

DocumentFormat.OpenXml.Wordprocessing.UseSingleBor

However, if this compatibility setting is turned on:

<w:compat>
<w:useSingleBorderforContiguousCells />
</w:compat>

Then the simplified table algorithm above shall be used instead (bottom and right cell borders always win), resulting in the following output:

DocumentFormat.OpenXml.Wordprocessing.UseSingleBor

end example]

Parent Elements

compat (Part 1, §17.15.1.21)

This element’s content model is defined by the common boolean property definition in Part 1, §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.

See Also

Reference

UseSingleBorderForContiguousCells Members

DocumentFormat.OpenXml.Wordprocessing Namespace