w:tblOverlap (Floating Table Overlap)

Specifies whether a floating table may overlap with other floating tables in the document.

Parent elements

w:tblPr

Description

w:tblOverlap controls whether a floating table (one with w:tblpPr) is allowed to visually overlap with other floating tables. When set to never, the table repositions itself to avoid overlapping with other floating objects.

It is defined in ECMA-376 Part 1 §17.4.54.

w:tblOverlap is only meaningful for floating tables (those that have w:tblpPr).

Attributes

Attribute	Type	Possible Values	Description
`w:val`	`ST_TblOverlap`	`never`, `overlap`	Whether overlapping with other floating tables is permitted.

Values

Value	Description
`overlap`	The floating table may overlap other floating tables (default).
`never`	The table repositions to avoid overlapping other floating tables.

Examples

<w:tblPr>
  <w:tblpPr w:horzAnchor="margin" w:tblpXSpec="right" w:vertAnchor="text" w:tblpY="0"/>
  <w:tblOverlap w:val="never"/>
</w:tblPr>

using DocumentFormat.OpenXml.Wordprocessing;

var tblPr = new TableProperties(
    new TablePositionProperties
    {
        HorizontalAnchor = HorizontalAnchorValues.Margin,
        TablePositionXAlignment = HorizontalAlignmentValues.Right,
        VerticalAnchor = VerticalAnchorValues.Text,
        TablePositionY = 0
    },
    new TableOverlap { Val = TableOverlapValues.Never }
);

Notes

w:tblOverlap has no effect on inline (non-floating) tables.
Most rendering engines support never by pushing the table below any preceding floating table that would otherwise overlap.